TextRange Classe

Definição

public ref class TextRange

public class TextRange

type TextRange = class

Public Class TextRange

Herança

Object

TextRange

Derivado

System.Windows.Documents.TextSelection

Exemplos

O exemplo seguinte demonstra o uso da Text propriedade de a TextRange para devolver a representação em texto simples de um determinado FlowDocument.

// This method returns a plain text representation of a specified FlowDocument.
string GetTextFromFlowDocument(FlowDocument flowDoc)
{
     // Create a new TextRanage that takes the entire FlowDocument as the current selection.
     TextRange flowDocSelection = new TextRange(flowDoc.ContentStart, flowDoc.ContentEnd);
      
     // Use the Text property to extract a string that contains the unformatted text contents 
     // of the FlowDocument.
     return flowDocSelection.Text;
}

' This method returns a plain text representation of a specified FlowDocument.
Private Function GetTextFromFlowDocument(ByVal flowDoc As FlowDocument) As String
    ' Create a new TextRanage that takes the entire FlowDocument as the current selection.
    Dim flowDocSelection As New TextRange(flowDoc.ContentStart, flowDoc.ContentEnd)

    ' Use the Text property to extract a string that contains the unformatted text contents 
    ' of the FlowDocument.
    Return flowDocSelection.Text
End Function

Observações

A TextRange aula introduz a seguinte terminologia.

• Seleção - A TextRange é uma seleção de conteúdo entre duas posições indicadas por TextPointers. Uma destas posições é uma âncora fixa em relação à seleção, enquanto a outra posição é móvel. Isto é semelhante ao comportamento de uma seleção feita por um utilizador usando rato ou teclado.

• Seleção Atual - Como a TextRange indica sempre uma seleção no conteúdo, faz sentido simplesmente referir-se à seleção indicada por a TextRange como a seleção atual.

• Recipiente de Texto - Um contentor de texto é o elemento que forma a fronteira final para o conteúdo do fluxo em questão; A seleção indicada por um TextRange cai sempre dentro de um recipiente de texto. Atualmente, um recipiente de texto deve ser ou a FlowDocument ou um TextBlock.

• Documento - O conteúdo coletivamente contido num contentor de texto é referido como documento.

Para mais informações sobre outros termos relacionados como posição, veja TextPointer.

Ver também

• TextPointerContext