TextPointer.CompareTo(TextPointer) Yöntem

Tanım

Ad Alanı:

System.Windows.Documents

Bütünleştirilmiş Kod:

PresentationFramework.dll

Geçerli TextPointer ile belirtilen ikinci TextPointerbir tarafından belirtilen konumlar arasında sıralı bir karşılaştırma gerçekleştirir.

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

Parametreler

position

TextPointer

TextPointer Geçerli konumla karşılaştıracak konumu belirten bir.

Döndürülenler

Int32

-1 geçerli TextPointer değerden önceyseposition; konumlar aynıysa 0; geçerli TextPointer ise +1.position

Özel durumlar

ArgumentException

position geçerli konumla ilişkili metin kapsayıcısının dışında bir konum belirtir.

Örnekler

Aşağıdaki örnekte bu yöntem için bir kullanım gösterilmektedir. Örnekte yöntemi, CompareTo belirtilen TextElement bir boş olup olmadığını test etmek için yöntemiyle GetInsertionPosition birlikte kullanılır.

// 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.

Açıklamalar

-1 değeri, geçerli TextPointer tarafından belirtilen konumun tarafından positionbelirtilen konumdan önce geldiğini gösterir. 0 değeri, belirtilen konumların eşit olduğunu gösterir. Pozitif +1 değeri, geçerli TextPointer tarafından belirtilen konumun tarafından positionbelirtilen konumu izlediğini gösterir.

Ayrıca bkz.

• IsInSameDocument(TextPointer)