TextRange(TextPointer, TextPointer) Constructor

Definición

Inicializa una nueva instancia de la clase TextRange, que toma dos posiciones TextPointer especificadas como las posiciones inicial y final para el nuevo intervalo.Initializes a new instance of the TextRange class, taking two specified TextPointer positions as the beginning and end positions for the new range.

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

Una posición de anclaje fija que marca un extremo de la selección utilizada para formar el nuevo TextRange.A fixed anchor position that marks one end of the selection used to form the new TextRange.

position2
TextPointer

Una posición movible que marca el otro extremo de la selección utilizada para formar el nuevo TextRange.A movable position that marks the other end of the selection used to form the new TextRange.

Excepciones

Se produce cuando position1 y position2 no se colocan dentro del mismo documento.Occurs when position1 and position2 are not positioned within the same document.

Se produce cuando el valor de position1 o position2 es null.Occurs when position1 or position2 is null.

Ejemplos

En el siguiente ejemplo se muestra el uso del constructor TextRange.The following example demonstrates the use of the TextRange constructor.

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

Comentarios

Un TextRange se forma a partir de una selección entre dos posiciones indicadas por punteros.A TextRange is formed from a selection between two positions indicated by TextPointers. Una de estas posiciones (indicada por position1) se fija con respecto a la selección, mientras que la otra posición (indicada por position2) es movible.One of these positions (indicated by position1) is fixed with respect to the selection, while the other position (indicated by position2) is movable. Esto es similar a la forma en que se comporta la selección realizada por un usuario mediante el mouse o el teclado.This is similar to how a selection made by a user using the mouse or keyboard behaves.

Los extremos reales del nuevo TextRange pueden ajustarse para que coincidan con cualquier heurística de selección que se aplique al documento que contiene el nuevo TextRange.The actual ends of the new TextRange may be adjusted to match any selection heuristics that are applicable to the document that contains the new TextRange.

Se aplica a