TextRange(TextPointer, TextPointer) Construtor

Definição

Namespace:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Inicializa uma nova instância da classe TextRange, assumindo duas posições TextPointer especificadas como as posições inicial e final do novo intervalo.

public:
 TextRange(System::Windows::Documents::TextPointer ^ position1, System::Windows::Documents::TextPointer ^ position2);

public TextRange (System.Windows.Documents.TextPointer position1, System.Windows.Documents.TextPointer position2);

new System.Windows.Documents.TextRange : System.Windows.Documents.TextPointer * System.Windows.Documents.TextPointer -> System.Windows.Documents.TextRange

Public Sub New (position1 As TextPointer, position2 As TextPointer)

Parâmetros

position1

TextPointer

Uma posição de ancoragem fixa que marca uma extremidade da seleção usada para formar o novo TextRange.

position2

TextPointer

Uma posição móvel que marca a outra extremidade da seleção usada para formar o novo TextRange.

Exceções

ArgumentException

Ocorre quando position1 e position2 não estão posicionados dentro do mesmo documento.

ArgumentNullException

Ocorre quando position1 ou position2 é null.

Exemplos

O exemplo a seguir demonstra o uso do TextRange construtor.

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

Comentários

A TextRange é formada a partir de uma seleção entre duas posições indicadas por TextPointers. Uma dessas posições (indicada por position1) é fixada em relação à seleção, enquanto a outra posição (indicada por position2) é móvel. Isso é semelhante a como uma seleção feita por um usuário que usa o mouse ou teclado se comporta.

As extremidades reais do novo TextRange podem ser ajustadas para corresponder a qualquer heurística de seleção aplicável ao documento que contém o novo TextRange.