TextRange(TextPointer, TextPointer) Constructeur
Définition
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
Se produit quand position1
et position2
ne sont pas positionnés dans le même document.
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.