TextPointer.GetTextInRun Método

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

Parâmetros

Devoluções

Uma cadeia contendo qualquer texto adjacente na direção lógica especificada, ou Empty se não for possível encontrar texto adjacente.

Exemplos

O exemplo seguinte demonstra a utilização deste método. O exemplo utiliza o GetTextInRun método para implementar um extrator de texto simples. O método devolve uma concatenação de strings de todo o texto entre duas instâncias especificadas TextPointer .

Embora o exemplo possa ser usado para extrair qualquer texto entre duas TextPointer instâncias, destina-se apenas a fins ilustrativos e não deve ser usado em código de produção. Utilize a propriedade TextRange.Text em vez disso.

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

Observações

Este método devolve apenas sequências ininterruptas de texto. Nada é devolvido se qualquer tipo de símbolo diferente Text de estiver adjacente à corrente TextPointer na direção especificada. De forma semelhante, o texto é devolvido apenas até ao símbolo não textual seguinte.

Ver também

• 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

Parâmetros

Devoluções

O número de caracteres realmente copiados para textBuffer.

Exceções

Observações

Este método devolve apenas sequências ininterruptas de texto. Nada é devolvido se qualquer tipo de símbolo diferente Text de estiver adjacente à corrente TextPointer na direção especificada. De forma semelhante, o texto é devolvido apenas até ao símbolo não textual seguinte.

Ver também

• DeleteTextInRun(Int32)
• InsertTextInRun(String)