TextRange(TextPointer, TextPointer) Constructeur

Référence

Définition

Espace de noms:: System.Windows.Documents

Assembly:: PresentationFramework.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Initialise une nouvelle instance de la classe TextRange, en prenant deux positions de TextPointer spécifiées en tant que positions de départ et de fin de la nouvelle plage.

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)

Paramètres

position1: TextPointer

Position d'ancrage fixe qui marque une extrémité de la sélection utilisée pour former la nouvelle plage TextRange.

position2: TextPointer

Position mobile qui marque l'autre extrémité de la sélection utilisée pour former la nouvelle plage TextRange.

Exceptions

ArgumentException

Se produit quand position1 et position2 ne sont pas positionnés dans le même document.

ArgumentNullException

Se produit quand position1 ou position2 est null.

Exemples

L’exemple suivant illustre l’utilisation du TextRange constructeur.

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

Remarques

Un TextRange élément est formé à partir d’une sélection entre deux positions indiquées par TextPointers. L’une de ces positions (indiquées par position1) est fixe par rapport à la sélection, tandis que l’autre position (indiquée par position2) est mobile. Cela est similaire à la façon dont une sélection effectuée par un utilisateur à l’aide de la souris ou du clavier se comporte.

Les extrémités réelles du nouveau TextRange peuvent être ajustées pour correspondre à toutes les heuristiques de sélection applicables au document qui contient le nouveau TextRange.

S’applique à