TextRange Classe

Définition

Espace de noms:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Représente une sélection de contenu entre deux positions 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 propriété Text d’un TextRange pour renvoyer la représentation de texte brut d’un FlowDocumentspécifié.

// 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 classe TextRange présente la terminologie suivante.

• Sélection - Un 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’un TextRange indique toujours une sélection dans le contenu, il est judicieux de faire simplement référence à la sélection indiquée par un TextRange comme sélection actuelle.

• conteneur de texte - Un conteneur de texte est l’élément qui forme la bordure ultime du contenu de flux à la main ; la sélection indiquée par un 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 position, consultez TextPointer.

Constructeurs

TextRange(TextPointer, TextPointer)

Initialise une nouvelle instance de la classe TextRange, en prenant deux positions de TextPointer spécifiées comme positions de début et de fin pour la nouvelle plage.

Propriétés

End	Obtenez la position qui marque la fin de la sélection actuelle.
IsEmpty	Obtient une valeur indiquant si la sélection actuelle est vide ou non.
Start	Obtient la position qui marque le début de la sélection actuelle.
Text	Obtient ou définit le contenu de 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 la sélection actuelle peut être chargée avec du contenu dans un format de données spécifié.
CanSave(String)	Vérifie si la sélection actuelle peut être enregistrée sous forme de format de données spécifié.
ClearAllProperties()	Supprime toutes les propriétés de mise en forme (représentées par Inline éléments) de la sélection actuelle.
Contains(TextPointer)	Vérifie si une position (spécifiée par un TextPointer) se trouve dans la sélection actuelle.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert 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 dans la sélection actuelle.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
Load(Stream, String)	Charge la sélection actuelle dans un format de données spécifié à partir d’un flux spécifié.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
Save(Stream, String, Boolean)	Enregistre la sélection actuelle dans un flux spécifié dans un format de données spécifié, avec l’option de conservation des objets TextElement personnalisés.
Save(Stream, String)	Enregistre la sélection actuelle dans un flux spécifié dans un format de données spécifié.
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 pour couvrir une nouvelle étendue de contenu.

Voir aussi

• TextPointerContext