TextRange Classe

Définition

Espace de noms:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Représente une sélection de contenu entre deux positions de TextPointer.

public ref class TextRange

public class TextRange

type TextRange = class

Public Class TextRange

Héritage

Object

TextRange

Dérivé

System.Windows.Documents.TextSelection

Exemples

L’exemple suivant illustre l’utilisation de la Text propriété d’un TextRange pour renvoyer la représentation en texte brut d’un spécifié FlowDocument.

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

La TextRange classe présente la terminologie suivante.

• Sélection : A TextRange est une sélection de contenu entre deux positions indiquées par TextPointers. L’une de ces positions est une ancre fixe par rapport à la sélection, tandis que l’autre position 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.

• Sélection actuelle : étant donné qu’une TextRange sélection est toujours indiquée dans le contenu, il est judicieux de simplement faire référence à la sélection indiquée par une TextRange sélection actuelle.

• Conteneur de texte : un conteneur de texte est l’élément qui forme la bordure ultime du contenu de flux à portée de main; la sélection indiquée par un TextRange conteneur de texte se trouve toujours dans un conteneur de texte. Actuellement, un conteneur de texte doit être un FlowDocument ou un TextBlock.

• Document : le contenu contenu collectivement contenu dans un conteneur de texte est appelé document.

Pour plus d’informations sur d’autres termes connexes tels que la position, consultez TextPointer.

Constructeurs

TextRange(TextPointer, TextPointer)

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.

Propriétés

End	Obtient la position qui marque l'extrémité de la sélection actuelle.
IsEmpty	Obtient une valeur qui indique si la sélection actuelle est vide.
Start	Obtient la position qui marque le début de la sélection actuelle.
Text	Obtient ou définit le contenu en texte brut de la sélection actuelle.

Méthodes

ApplyPropertyValue(DependencyProperty, Object)	Applique une propriété et une valeur de mise en forme spécifiées à la sélection actuelle.
CanLoad(String)	Vérifie si du contenu peut être chargé dans la sélection actuelle à un format de données spécifié.
CanSave(String)	Vérifie si la sélection actuelle peut être enregistrée à un format de données spécifié.
ClearAllProperties()	Supprime toutes les propriétés de mise en forme (représentées par des éléments Inline) de la sélection actuelle.
Contains(TextPointer)	Vérifie si une position (spécifiée par un TextPointer) est située dans la sélection actuelle.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetPropertyValue(DependencyProperty)	Retourne la valeur effective d'une propriété de mise en forme spécifiée pour la sélection actuelle.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
Load(Stream, String)	Charge la sélection actuelle au format de données spécifié à partir d'un flux de données indiqué.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Save(Stream, String)	Enregistre la sélection actuelle au format de données spécifié dans le flux indiqué.
Save(Stream, String, Boolean)	Enregistre la sélection actuelle au format de données spécifié dans le flux indiqué, en conservant éventuellement les objets TextElement personnalisés.
Select(TextPointer, TextPointer)	Met à jour la sélection actuelle, en prenant deux positions TextPointer pour indiquer la sélection mise à jour.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Événements

Changed

Se produit lorsque la plage est repositionnée de façon à couvrir un nouvel intervalle du contenu.

Voir aussi

• TextPointerContext