TextPointer.CompareTo(TextPointer) Metode

Definisi

Ruang nama:
System.Windows.Documents
Rakitan:
PresentationFramework.dll

Melakukan perbandingan ordinal antara posisi yang ditentukan oleh saat ini TextPointer dan detik yang ditentukan 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

Parameter

position
TextPointer

TextPointer yang menentukan posisi untuk dibandingkan dengan posisi saat ini.

Mengembalikan

Int32

-1 jika sebelumnya positionsaat ini TextPointer ; 0 jika lokasinya sama; +1 jika saat ini TextPointer mengikuti position.

Pengecualian

ArgumentException

position menentukan posisi di luar kontainer teks yang terkait dengan posisi saat ini.

Contoh

Contoh berikut menunjukkan penggunaan untuk metode ini. Dalam contoh, CompareTo metode ini digunakan bersama dengan GetInsertionPosition metode untuk menguji apakah yang ditentukan TextElement kosong.

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

Keterangan

Nilai -1 menunjukkan bahwa posisi yang ditentukan oleh saat ini TextPointer mendahului posisi yang ditentukan oleh position. Nilai 0 menunjukkan bahwa posisi yang ditunjukkan sama. Nilai positif +1 menunjukkan bahwa posisi yang ditentukan oleh saat ini TextPointer mengikuti posisi yang ditentukan oleh position.

Berlaku untuk

Lihat juga