TextPointer クラス

定義

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

継承

Object

ContentPosition

TextPointer

例

次の例では、 を使用 TextPointer して、指定したテキスト コンテナー内の最初 Run の要素の内側にある位置を検索する方法を示します。

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

次の例では、機能を使用して単純な検索アルゴリズムを TextPointer 実装します。

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

注釈

クラスには TextPointer 、次の用語が導入されています。

• 位置 - 本質的に、 は TextPointer 常にコンテンツ内の 位置 を指します。 このような位置は、コンテンツ内の文字間、またはコンテンツの構造を定義するフロー コンテンツ要素タグの間に位置します。

• 現在の位置 - は常に位置を示し、 を介してTextPointer実行できる操作の多くは、 によってTextPointer現在指されている位置に対して相対的であるためTextPointer、 によってTextPointer示される位置を現在の位置として参照するだけでは理にかなっています。

• 挿入位置 - 挿入位置 は、関連付けられたコンテンツのセマンティック ルールを損なうことなく、新しいコンテンツを追加できる位置です。 実際には、挿入位置は、キャレットが配置される可能性があるコンテンツ内の任意の場所です。 挿入位置ではない有効な TextPointer 位置の例は、2 つの隣接する Paragraph タグ間 (つまり、前の段落の終了タグと次の段落の開始タグの間) の位置です。

• シンボル - シンボルを含む操作の TextPointer 目的で、次のいずれかが シンボルと見なされます。

  • 要素の開始タグまたは終了タグ TextElement 。

  • UIElementまたは BlockUIContainerにInlineUIContainer含まれる要素。 このような は UIElement 常に 1 つのシンボルとしてカウントされます。に含まれる UIElement 追加のコンテンツまたは要素はシンボルとしてカウントされません。

  • テキスト Run 要素内の各 16 ビット Unicode 文字。

• テキスト コンテナー - テキスト コンテナー は、手元のフロー コンテンツの最終的な境界線を形成する要素です。によって示される位置は TextPointer 、常にテキスト コンテナー内に含まれます。 現在、テキスト コンテナーは または であるFlowDocumentTextBlock必要があります。 一般に、異なるテキスト コンテナー内のインスタンス間 TextPointer の操作はサポートされていません。

• Document - テキスト コンテナー内のコンテンツは、 メソッドと プロパティおよび DocumentEnd プロパティのようにIsInSameDocument、ドキュメントとDocumentStart呼ばれます。

クラスはTextPointer、Windows Presentation Foundation (WPF) フロー コンテンツ要素によって表されるコンテンツのトラバーサルと操作を容易にすることを目的としています。一般に、このような要素は からTextElement派生します。 次のような操作 TextPointer が容易になります。

• 現在の位置と 2 番目の指定した位置の序数比較を実行します。 メソッドを CompareTo 参照してください。

• 指定した方向の現在位置に隣接するコンテンツの種類を決定します。 メソッドとTextPointerContext列挙体をGetPointerContext参照してください。

• 現在の位置に TextElement 隣接する または をスコープとする を取得します。 および メソッドをGetAdjacentElement参照してくださいParagraph。

• 現在のドキュメントをスコープとするテキスト コンテナーを取得します。 Parent プロパティをご覧ください。

• 現在の位置の前または後に指定した文字数を取得します。 メソッドを GetTextInRun 参照してください。

• 現在の位置に文字の文字列を挿入します。 メソッドを InsertTextInRun 参照してください。

• コンテンツ内の線の境界を検索します。 メソッドとIsAtLineStartPositionプロパティをGetLineStartPosition参照してください。

• 位置とシンボル オフセットの間 TextPointer をコンテンツに変換します。 メソッドと GetPositionAtOffset メソッドをGetOffsetToPosition参照してください。

• 位置とPoint相対座標を表す の間でTextPointer変換することで、視覚的なヒット テストを実行します。

• 近くの挿入位置を検索するか、現在の位置が挿入位置であるかどうかを確認します。 GetInsertionPositionおよび GetNextInsertionPosition メソッドと プロパティをIsAtInsertionPosition参照してください。

オブジェクトによってTextPointer示される 位置LogicalDirectionは変更できません。 コンテンツが編集または変更されると、 によって TextPointer 示される位置は周囲のテキストに対して相対的に変化しません。コンテンツの先頭からの位置のオフセットは、コンテンツ内の新しい相対位置を反映するように対応して調整されます。 たとえば、特定の段落の先頭の位置を示す は、 TextPointer 段落の前後にコンテンツが挿入または削除された場合でも、その段落の先頭を指し続けます。

クラスは TextPointer パブリック コンストラクターを提供しません。 のインスタンスは、他のオブジェクト (他TextPointerのTextPointerオブジェクトを含む) のプロパティまたはメソッドを使用して作成されます。 次の一覧では、 を作成して返すメソッドとプロパティの例をいくつか TextPointer示します。 この一覧は完全ではありません。

• TextRangeから : Start と End。

• TextElementから: ContentStart、、ContentEnd、ElementStartおよび ElementEnd。

• TextBlock (テキスト コンテナー): ContentStart、ContentEnd、および GetPositionFromPoint。

• FlowDocument (テキスト コンテナー): ContentStart、およびContentEnd

• 既存 TextPointerの : DocumentStart、、 DocumentEnd、 GetNextInsertionPositionおよび GetPositionAtOffsetから。

プロパティ

メソッド

適用対象

こちらもご覧ください

• TextRange
• TextPointerContext
• TextElement