TextRange(TextPointer, TextPointer) Costruttore

Definizione

Spazio dei nomi:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Inizializza un'istanza nuova della classe TextRange, considerando due posizioni TextPointer specificate come posizioni di inizio e di fine per il nuovo intervallo.

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)

Parametri

position1

TextPointer

Posizione dell'ancoraggio fissa che marca un'estremità della selezione utilizzata per formare il nuovo oggetto TextRange.

position2

TextPointer

Posizione mobile che contrassegna l'altra estremità della selezione utilizzata per formare il nuovo oggetto TextRange.

Eccezioni

ArgumentException

Si verifica quando position1 e position2 non sono posizionati nello stesso documento.

ArgumentNullException

Viene generato quando position1 o position2 è null.

Esempio

Nell'esempio seguente viene illustrato l'uso del TextRange costruttore.

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

Commenti

Un TextRange oggetto viene formato da una selezione tra due posizioni indicate da TextPointers. Una di queste posizioni (indicata da position1) è fissa rispetto alla selezione, mentre l'altra posizione (indicata da position2) è rimovibile. Si tratta di un comportamento simile a quello di una selezione effettuata da un utente che usa il mouse o la tastiera.

Le estremità effettive del nuovo TextRange possono essere modificate per corrispondere a qualsiasi heuristica di selezione applicabile al documento che contiene il nuovo TextRange.