TextPointer.GetNextInsertionPosition(LogicalDirection) Metode

Definisi

Ruang nama:

System.Windows.Documents

Rakitan:

PresentationFramework.dll

Mengembalikan TextPointer ke posisi penyisipan berikutnya dalam arah logika yang ditentukan.

public:
 System::Windows::Documents::TextPointer ^ GetNextInsertionPosition(System::Windows::Documents::LogicalDirection direction);

public System.Windows.Documents.TextPointer GetNextInsertionPosition (System.Windows.Documents.LogicalDirection direction);

member this.GetNextInsertionPosition : System.Windows.Documents.LogicalDirection -> System.Windows.Documents.TextPointer

Public Function GetNextInsertionPosition (direction As LogicalDirection) As TextPointer

Parameter

direction

LogicalDirection

Salah LogicalDirection satu nilai yang menentukan arah logis untuk mencari posisi penyisipan berikutnya.

Mengembalikan

TextPointer

TextPointer Yang mengidentifikasi posisi penyisipan berikutnya ke arah yang diminta, atau null jika tidak ada posisi penyisipan berikutnya yang dapat ditemukan.

Contoh

Contoh berikut menunjukkan penggunaan untuk metode ini. Contohnya menggunakan GetNextInsertionPosition metode untuk melintasi batas elemen konten untuk menghitung jumlah Paragraph elemen yang ada di antara dua instans tertentu TextPointer .

// This method returns the number of pagragraphs between two
// specified TextPointers.
int GetParagraphCount(TextPointer start, TextPointer end)
{
    int paragraphCount = 0;
 
    while (start != null && start.CompareTo(end) < 0)
    {
        Paragraph paragraph = start.Paragraph;
 
        if (paragraph != null)
        {
            paragraphCount++;
 
            // Advance start to the end of the current paragraph.
            start = paragraph.ContentEnd;
         }
 
         // Use the GetNextInsertionPosition method to skip over any interceding
         // content element tags.
         start = start.GetNextInsertionPosition(LogicalDirection.Forward);
     } // End while.
 
         return paragraphCount;
}  // End GetParagraphCount.

' This method returns the number of pagragraphs between two
' specified TextPointers.
Private Function GetParagraphCount(ByVal start As TextPointer, ByVal [end] As TextPointer) As Integer
    Dim paragraphCount As Integer = 0

    Do While start IsNot Nothing AndAlso start.CompareTo([end]) < 0
        Dim paragraph As Paragraph = start.Paragraph

        If paragraph IsNot Nothing Then
            paragraphCount += 1

            ' Advance start to the end of the current paragraph.
            start = paragraph.ContentEnd
        End If

        ' Use the GetNextInsertionPosition method to skip over any interceding
        ' content element tags.
        start = start.GetNextInsertionPosition(LogicalDirection.Forward)

    Loop ' End while.

    Return paragraphCount

End Function ' End GetParagraphCount.

Keterangan

Posisi penyisipan adalah posisi di mana konten baru dapat ditambahkan tanpa melanggar aturan semantik untuk konten terkait. Dalam praktiknya, posisi penyisipan berada di mana saja dalam konten di mana tanda sisipan dapat diposisikan. Contoh posisi valid TextPointer yang bukan posisi penyisipan adalah posisi antara dua tag yang berdekatan Paragraph (yaitu, antara tag penutup paragraf sebelumnya dan tag pembuka paragraf berikutnya).

Lihat juga

• GetInsertionPosition(LogicalDirection)