TextPointer.CompareTo(TextPointer) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Utför en ordningsjämförelse mellan de positioner som anges av den aktuella TextPointer och en andra angiven TextPointer.
public:
int CompareTo(System::Windows::Documents::TextPointer ^ position);
public int CompareTo(System.Windows.Documents.TextPointer position);
member this.CompareTo : System.Windows.Documents.TextPointer -> int
Public Function CompareTo (position As TextPointer) As Integer
Parametrar
- position
- TextPointer
En TextPointer som anger en position att jämföra med den aktuella positionen.
Returer
-1 om strömmen TextPointer föregår position; 0 om platserna är samma; +1 om strömmen TextPointer följer position.
Undantag
position anger en position utanför textcontainern som är associerad med den aktuella positionen.
Exempel
I följande exempel visas en användning för den här metoden. I exemplet CompareTo används metoden tillsammans med GetInsertionPosition metoden för att testa om en angiven TextElement är tom.
// Tests to see if the specified TextElement is empty (has no printatble content).
bool IsElementEmpty(TextElement element)
{
// Find starting and ending insertion positions in the element.
// Inward-facing directions are used to make sure that insertion position
// will be found correctly in case when the element may contain inline
// formatting elements (such as a Span or Run that contains Bold or Italic elements).
TextPointer start = element.ContentStart.GetInsertionPosition(LogicalDirection.Forward);
TextPointer end = element.ContentEnd.GetInsertionPosition(LogicalDirection.Backward);
// The element has no printable content if its first and last insertion positions are equal.
return start.CompareTo(end) == 0;
} // End IsEmptyElement method.
' Tests to see if the specified TextElement is empty (has no printatble content).
Private Function IsElementEmpty(ByVal element As TextElement) As Boolean
' Find starting and ending insertion positions in the element.
' Inward-facing directions are used to make sure that insertion position
' will be found correctly in case when the element may contain inline
' formatting elements (such as a Span or Run that contains Bold or Italic elements).
Dim start As TextPointer = element.ContentStart.GetInsertionPosition(LogicalDirection.Forward)
Dim [end] As TextPointer = element.ContentEnd.GetInsertionPosition(LogicalDirection.Backward)
' The element has no printable content if its first and last insertion positions are equal.
Return start.CompareTo([end]) = 0
End Function ' End IsEmptyElement method.
Kommentarer
Värdet -1 anger att den position som anges av strömmen TextPointer föregår den position som anges av position. Värdet 0 anger att de angivna positionerna är lika med. Värdet positiv +1 anger att den position som anges av strömmen TextPointer följer den position som anges av position.