TextPointer Sınıf

Tanım

public ref class TextPointer : System::Windows::Documents::ContentPosition

public class TextPointer : System.Windows.Documents.ContentPosition

type TextPointer = class
    inherit ContentPosition

Public Class TextPointer
Inherits ContentPosition

Devralma

Object

ContentPosition

TextPointer

Örnekler

Aşağıdaki örnekte, belirtilen metin kapsayıcısında ilk Run öğesinin hemen içinde bir konum bulmak için TextPointer nasıl kullanılacağı gösterilmektedir.

// This method returns the position just inside of the first text Run (if any) in a 
// specified text container.
TextPointer FindFirstRunInTextContainer(DependencyObject container)
{
    TextPointer position = null;

    if (container != null){
        if (container is FlowDocument)
            position = ((FlowDocument)container).ContentStart;
        else if (container is TextBlock)
            position = ((TextBlock)container).ContentStart;
        else
            return position;
    }
    // Traverse content in forward direction until the position is immediately after the opening 
    // tag of a Run element, or the end of content is encountered.
    while (position != null)
    {
        // Is the current position just after an opening element tag?
        if (position.GetPointerContext(LogicalDirection.Backward) == TextPointerContext.ElementStart)
        {
            // If so, is the tag a Run?
            if (position.Parent is Run)
                break;
        }

        // Not what we're looking for; on to the next position.
        position = position.GetNextContextPosition(LogicalDirection.Forward);
    }
        
    // This will be either null if no Run is found, or a position just inside of the first Run element in the
    // specifed text container.  Because position is formed from ContentStart, it will have a logical direction
    // of Backward.
    return position;
}

' This method returns the position just inside of the first text Run (if any) in a 
' specified text container.
Private Function FindFirstRunInTextContainer(ByVal container As DependencyObject) As TextPointer
    Dim position As TextPointer = Nothing

    If container IsNot Nothing Then
        If TypeOf container Is FlowDocument Then
            position = (CType(container, FlowDocument)).ContentStart
        ElseIf TypeOf container Is TextBlock Then
            position = (CType(container, TextBlock)).ContentStart
        Else
            Return position
        End If
    End If
    ' Traverse content in forward direction until the position is immediately after the opening 
    ' tag of a Run element, or the end of content is encountered.
    Do While position IsNot Nothing
        ' Is the current position just after an opening element tag?
        If position.GetPointerContext(LogicalDirection.Backward) = TextPointerContext.ElementStart Then
            ' If so, is the tag a Run?
            If TypeOf position.Parent Is Run Then
                Exit Do
            End If
        End If

        ' Not what we're looking for on to the next position.
        position = position.GetNextContextPosition(LogicalDirection.Forward)
    Loop

    ' This will be either null if no Run is found, or a position just inside of the first Run element in the
    ' specifed text container.  Because position is formed from ContentStart, it will have a logical direction
    ' of Backward.
    Return position
End Function

Aşağıdaki örnek, TextPointer olanaklarını kullanarak basit bir bulma algoritması uygular.

// This method will search for a specified word (string) starting at a specified position.
TextPointer FindWordFromPosition(TextPointer position, string word)
{
    while (position != null)
    {
         if (position.GetPointerContext(LogicalDirection.Forward) == TextPointerContext.Text)
         {
             string textRun = position.GetTextInRun(LogicalDirection.Forward);

             // Find the starting index of any substring that matches "word".
             int indexInRun = textRun.IndexOf(word);
             if (indexInRun >= 0)
             {
                 position = position.GetPositionAtOffset(indexInRun);
                 break;
             }
         }
         else
        {
            position = position.GetNextContextPosition(LogicalDirection.Forward);
        }
    }

     // position will be null if "word" is not found.
     return position; 
}

' This method will search for a specified word (string) starting at a specified position.
Private Function FindWordFromPosition(ByVal position As TextPointer, ByVal word As String) As TextPointer
    Do While position IsNot Nothing
        If position.GetPointerContext(LogicalDirection.Forward) = TextPointerContext.Text Then
            Dim textRun As String = position.GetTextInRun(LogicalDirection.Forward)

            ' Find the starting index of any substring that matches "word".
            Dim indexInRun As Integer = textRun.IndexOf(word)
            If indexInRun >= 0 Then
                position = position.GetPositionAtOffset(indexInRun)
                Exit Do
            End If
        Else
            position = position.GetNextContextPosition(LogicalDirection.Forward)
        End If
    Loop

    ' position will be null if "word" is not found.
    Return position
End Function

Açıklamalar

TextPointer sınıfı aşağıdaki terminolojiyi tanıtır:

• Konum - Doğal olarak, bir her zaman içerikte konumu gösterir. Bu tür konumlar içerikteki karakterler arasında veya içeriğin yapısını tanımlayan akış içerik öğesi etiketleri arasında yer alır.

• Geçerli Konum - her zaman bir konumu gösterdiğinden ve bir aracılığıyla gerçekleştirilebilecek işlemlerin çoğu şu anda tarafından işaret edilen konuma göre olduğundan, tarafından gösterilen konumageçerli konumu olarak başvurmak mantıklıdır.

• Ekleme Konumu - ekleme konumu, ilişkili içerik için herhangi bir semantik kuralı bozmadan yeni içeriğin eklenebileceği bir konumdur. Uygulamada ekleme konumu, içerikte bir şapka işaretinin konumlandırılabileceği herhangi bir yerdir. Ekleme konumu olmayan geçerli bir TextPointer konumuna örnek olarak, iki bitişik Paragraph etiketi (önceki paragrafın kapanış etiketi ile sonraki paragrafın açılış etiketi arasındaki) arasındaki konum verilebilir.

• Sembol - Sembol içeren işlemleri için, aşağıdakilerden herhangi birisembolü olarak kabul edilir:

  • bir TextElement öğesi için açma veya kapatma etiketi.

  • bir InlineUIContainer veya BlockUIContaineriçinde yer alan bir UIElement öğesi. Bu tür bir UIElement her zaman tam olarak bir simge olarak sayılır; UIElement içerdiği ek içerik veya öğeler simge olarak sayılmaz.

  • Bir metin Run öğesinin içindeki her 16 bit Unicode karakteri.

• Metin Kapsayıcısı - metin kapsayıcısı, eldeki akış içeriği için en üst sınırı oluşturan öğedir; bir tarafından gösterilen konum her zaman bir metin kapsayıcısının içinde yer alır. Şu anda metin kapsayıcısı bir FlowDocument veya TextBlockolmalıdır. Genel olarak bakıldığında, farklı metin kapsayıcılarındaki TextPointer örnekleri arasındaki işlemler desteklenmez.

• Belge - Metin kapsayıcılarındaki içerik, yönteminde ve ve özelliklerinde olduğu gibibelgesi olarak adlandırılır.

TextPointer sınıfı, Windows Presentation Foundation (WPF) akış içeriği öğeleri tarafından temsil edilen içeriğin çapraz geçişini ve işlemesini kolaylaştırmaya yöneliktir; genel olarak, bu tür öğeler TextElementtüretilir. TextPointer kolaylaştırıcı işlemlerden bazıları şunlardır:

• Geçerli konumun sıralı karşılaştırmasını ikinci bir belirtilen konumla gerçekleştirin. CompareTo yöntemine bakın.

• Belirtilen yönde geçerli konuma bitişik içerik türünü belirleyin. GetPointerContext yöntemine ve TextPointerContext numaralandırmaya bakın.

• Kapsamı veya geçerli konuma bitişik olan TextElement alın. Bkz. Paragraph ve GetAdjacentElement yöntemi.

• Geçerli belgenin kapsamını oluşturan metin kapsayıcısını alın. Parent özelliğine bakın.

• Geçerli konumdan önce veya sonra belirtilen sayıda karakter alın. GetTextInRun yöntemine bakın.

• Geçerli konuma bir karakter dizesi ekleyin. InsertTextInRun yöntemine bakın.

• İçerikte satır sınırlarını bulma. GetLineStartPosition yöntemine ve IsAtLineStartPosition özelliğine bakın.

• TextPointer konumlar ile sembol uzaklıkları arasında çeviri yapın. GetOffsetToPosition ve GetPositionAtOffset yöntemlerine bakın.

• TextPointer konumu ile göreli koordinatları temsil eden bir Point arasında çeviri yaparak görsel isabet testi gerçekleştirin.

• Yakındaki bir ekleme konumunu bulun veya geçerli konumun ekleme konumu olup olmadığını denetleyin. GetInsertionPosition ve GetNextInsertionPosition yöntemlerine ve IsAtInsertionPosition özelliğine bakın.

bir TextPointer nesnesi tarafından gösterilen konum ve LogicalDirection sabittir. İçerik düzenlendiğinde veya değiştirildiğinde, bir TextPointer tarafından gösterilen konum çevresindeki metne göre değişmez; bunun yerine bu konumun içeriğin başından uzaklığı, içerikteki yeni göreli konumu yansıtacak şekilde karşılık gelen şekilde ayarlanır. Örneğin, belirli bir paragrafın başındaki konumu gösteren bir TextPointer, içerik paragrafın önüne veya arkasına eklendiğinde veya silindiğinde bile bu paragrafın başına işaret etmeye devam eder.

TextPointer sınıfı herhangi bir genel oluşturucu sağlamaz. TextPointer örneği, diğer nesnelerin (diğer TextPointer nesneleri dahil) özellikleri veya yöntemleri kullanılarak oluşturulur. Aşağıdaki listede, TextPointeroluşturan ve döndüren yöntemlere ve özelliklere birkaç örnek verilmiştir. Bu liste kapsamlı değildir:

• bir TextRange: Start ve End.

• TextElement: ContentStart, ContentEnd, ElementStartve ElementEnd.

• bir TextBlock (metin kapsayıcısından): ContentStart, ContentEndve GetPositionFromPoint.

• FlowDocument (metin kapsayıcısından): ContentStartve ContentEnd

• Mevcut bir TextPointer: DocumentStart, DocumentEnd, GetNextInsertionPositionve GetPositionAtOffset.

Özellikler

Yöntemler

Şunlara uygulanır

Ayrıca bkz.

• TextRange
• TextPointerContext
• TextElement