TextPointer.GetNextContextPosition(LogicalDirection) Metódus

Definíció

Névtér:

System.Windows.Documents

Szerelvény:

PresentationFramework.dll

A megadott logikai irányban a következő szimbólumra mutató mutatót ad vissza.

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

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

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

Public Function GetNextContextPosition (direction As LogicalDirection) As TextPointer

Paraméterek

direction

LogicalDirection

Az egyik LogicalDirection érték, amely meghatározza a következő szimbólum keresésének logikai irányát.

Válaszok

TextPointer

A TextPointer a következő szimbólumra a kért irányban, vagy null ha az aktuális TextPointer szegély a tartalom kezdetét vagy végét jelöli.

Példák

Az alábbi példa a metódus használatát mutatja be. A példa a metódussal együtt használja a GetNextContextPosition metódust a GetPointerContext megadott szimbólumok TextElementbejárására és kinyerésére.

Bár a példa egy adott TextElementtartalom XAML-struktúrájának kinyerésére használható, csak szemléltető célokra szolgál, és nem használható éles kódban. Tekintse meg az System.Xml XML használatához és feldolgozásához tervezett számos típus névterét.

// This method will extract and return a string that contains a representation of 
// the XAML structure of content elements in a given TextElement.        
string GetXaml(TextElement element)
{
    StringBuilder buffer = new StringBuilder();
 
    // Position a "navigator" pointer before the opening tag of the element.
    TextPointer navigator = element.ElementStart;

    while (navigator.CompareTo(element.ElementEnd) < 0)
    {
        switch (navigator.GetPointerContext(LogicalDirection.Forward))
        {
            case TextPointerContext.ElementStart : 
                // Output opening tag of a TextElement
                buffer.AppendFormat("<{0}>", navigator.GetAdjacentElement(LogicalDirection.Forward).GetType().Name);
                break;
            case TextPointerContext.ElementEnd :
                // Output closing tag of a TextElement
                buffer.AppendFormat("</{0}>", navigator.GetAdjacentElement(LogicalDirection.Forward).GetType().Name);
                break;
            case TextPointerContext.EmbeddedElement :
                // Output simple tag for embedded element
                buffer.AppendFormat("<{0}/>", navigator.GetAdjacentElement(LogicalDirection.Forward).GetType().Name);
                break;
            case TextPointerContext.Text :
                // Output the text content of this text run
                buffer.Append(navigator.GetTextInRun(LogicalDirection.Forward));
                break;
        }
 
        // Advance the naviagtor to the next context position.
        navigator = navigator.GetNextContextPosition(LogicalDirection.Forward);
    } // End while.

    return buffer.ToString();
} // End GetXaml method.

' This method will extract and return a string that contains a representation of 
' the XAML structure of content elements in a given TextElement.        
Private Function GetXaml_Renamed(ByVal element As TextElement) As String
    Dim buffer As New StringBuilder()

    ' Position a "navigator" pointer before the opening tag of the element.
    Dim navigator As TextPointer = element.ElementStart

    Do While navigator.CompareTo(element.ElementEnd) < 0
        Select Case navigator.GetPointerContext(LogicalDirection.Forward)
            Case TextPointerContext.ElementStart
                ' Output opening tag of a TextElement
                buffer.AppendFormat("<{0}>", navigator.GetAdjacentElement(LogicalDirection.Forward).GetType().Name)
            Case TextPointerContext.ElementEnd
                ' Output closing tag of a TextElement
                buffer.AppendFormat("</{0}>", navigator.GetAdjacentElement(LogicalDirection.Forward).GetType().Name)
            Case TextPointerContext.EmbeddedElement
                ' Output simple tag for embedded element
                buffer.AppendFormat("<{0}/>", navigator.GetAdjacentElement(LogicalDirection.Forward).GetType().Name)
            Case TextPointerContext.Text
                ' Output the text content of this text run
                buffer.Append(navigator.GetTextInRun(LogicalDirection.Forward))
        End Select

        ' Advance the naviagtor to the next context position.
        navigator = navigator.GetNextContextPosition(LogicalDirection.Forward)

    Loop ' End while.

    Return buffer.ToString()

End Function ' End GetXaml method.

Megjegyzések

Az alábbiak bármelyike szimbólumnak minősül:

• Elem nyitó vagy záró címkéje TextElement .

• Egy UIElement vagy InlineUIContainertöbb elemet tartalmazó BlockUIContainer elem. Vegye figyelembe, hogy az UIElement ilyen elemeket mindig pontosan egy szimbólumnak számítják; a UIElement bennük található további tartalmak vagy elemek nem számítanak szimbólumnak.

• 16 bites Unicode-karakter egy szövegelemen Run belül.

Ha a következő szimbólum az , EmbeddedElementvagy (a ElementStart metódus által azonosított) kategóriába van sorolvaElementEnd, akkor a GetPointerContext metódus által visszaadott szimbólumot pontosan egy szimbólum emeli ki az TextPointer aktuális pozícióból.

Ha a következő szimbólum kategorizálva van, akkor a Text metódus által visszaadott TextPointerérték továbbhalad a szövegen a következő nem szöveges szimbólumra (azaz a következő pozícióra, ahol a TextPointerContext nemText). A pontos szimbólumok száma a metódus meghívásával GetTextRunLength előre kiszámítható.