TextPointer.GetTextInRun Méthode

public:
 System::String ^ GetTextInRun(System::Windows::Documents::LogicalDirection direction);

public string GetTextInRun (System.Windows.Documents.LogicalDirection direction);

member this.GetTextInRun : System.Windows.Documents.LogicalDirection -> string

Public Function GetTextInRun (direction As LogicalDirection) As String

Paramètres

Retours

Une chaîne contenant tout texte adjacent dans la direction logique spécifiée, ou Empty si aucun texte adjacent n'est décelable.

Exemples

L’exemple suivant illustre une utilisation de cette méthode. L’exemple utilise la GetTextInRun méthode pour implémenter un extracteur de texte simple. La méthode retourne une concaténation de chaîne de tout le texte entre deux instances spécifiées TextPointer .

Bien que l’exemple puisse être utilisé pour extraire n’importe quel texte entre deux TextPointer instances, il est destiné à des fins d’illustration uniquement et ne doit pas être utilisé dans le code de production. Utilisez plutôt la propriété TextRange.Text.

// Returns a string containing the text content between two specified TextPointers.
string GetTextBetweenTextPointers(TextPointer start, TextPointer end)
{
    StringBuilder buffer = new StringBuilder();
 
    while (start != null && start.CompareTo(end) < 0)
    {
        if (start.GetPointerContext(LogicalDirection.Forward) == TextPointerContext.Text)
            buffer.Append(start.GetTextInRun(LogicalDirection.Forward));
 
        // Note that when the TextPointer points into a text run, this skips over the entire
        // run, not just the current character in the run.
        start = start.GetNextContextPosition(LogicalDirection.Forward);
    }
    return buffer.ToString();
} // End GetTextBetweenPointers.

' Returns a string containing the text content between two specified TextPointers.
Private Function GetTextBetweenTextPointers(ByVal start As TextPointer, ByVal [end] As TextPointer) As String
    Dim buffer As New StringBuilder()

    Do While start IsNot Nothing AndAlso start.CompareTo([end]) < 0
        If start.GetPointerContext(LogicalDirection.Forward) = TextPointerContext.Text Then
            buffer.Append(start.GetTextInRun(LogicalDirection.Forward))
        End If

        ' Note that when the TextPointer points into a text run, this skips over the entire
        ' run, not just the current character in the run.
        start = start.GetNextContextPosition(LogicalDirection.Forward)
    Loop
    Return buffer.ToString()

End Function ' End GetTextBetweenPointers.

Remarques

Cette méthode retourne uniquement des exécutions de texte ininterrompues. Rien n’est retourné si un type de symbole autre que Text est adjacent au actuel TextPointer dans la direction spécifiée. De même, le texte est retourné uniquement jusqu’au symbole non texte suivant.

Voir aussi

• DeleteTextInRun(Int32)
• InsertTextInRun(String)

public:
 int GetTextInRun(System::Windows::Documents::LogicalDirection direction, cli::array <char> ^ textBuffer, int startIndex, int count);

public int GetTextInRun (System.Windows.Documents.LogicalDirection direction, char[] textBuffer, int startIndex, int count);

member this.GetTextInRun : System.Windows.Documents.LogicalDirection * char[] * int * int -> int

Public Function GetTextInRun (direction As LogicalDirection, textBuffer As Char(), startIndex As Integer, count As Integer) As Integer

Paramètres

Retours

Nombre réel de caractères copiés dans textBuffer.

Exceptions

Remarques

Cette méthode retourne uniquement des exécutions de texte ininterrompues. Rien n’est retourné si un type de symbole autre que Text est adjacent au actuel TextPointer dans la direction spécifiée. De même, le texte est retourné uniquement jusqu’au symbole non texte suivant.

Voir aussi

• DeleteTextInRun(Int32)
• InsertTextInRun(String)