TextPointer.CompareTo(TextPointer) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wykonuje porównanie porządkowe między pozycjami określonymi przez bieżącą TextPointer a drugą określoną TextPointerwartością .
public:
int CompareTo(System::Windows::Documents::TextPointer ^ position);public int CompareTo (System.Windows.Documents.TextPointer position);member this.CompareTo : System.Windows.Documents.TextPointer -> intPublic Function CompareTo (position As TextPointer) As IntegerParametry
- position
- TextPointer
Element TextPointer określający pozycję do porównania z bieżącą pozycją.
Zwraca
-1, jeśli bieżąca wartość TextPointer poprzedza position; 0, jeśli lokalizacje są takie same; +1, jeśli bieżąca wartość TextPointer jest następująca position.
Wyjątki
position określa położenie poza kontenerem tekstowym skojarzonym z bieżącym położeniem.
Przykłady
W poniższym przykładzie pokazano użycie tej metody. W tym przykładzie metoda jest używana w połączeniu z GetInsertionPosition metodą do testowania, CompareTo czy określony TextElement jest pusty.
// 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.
Uwagi
Wartość -1 wskazuje, że pozycja określona przez bieżący TextPointer poprzedza pozycję określoną przez position. Wartość 0 wskazuje, że wskazane pozycje są równe. Wartość dodatnia +1 wskazuje, że pozycja określona przez bieżącą TextPointer wartość jest zgodna z pozycją określoną przez positionwartość .
