TextRange Classe

Définition

Représente une sélection de contenu entre deux positions de TextPointer.Represents a selection of content between two TextPointer positions.

public ref class TextRange
public class TextRange
type TextRange = class
Public Class TextRange
Héritage
TextRange
Dérivé

Exemples

L’exemple suivant illustre l’utilisation de la propriété Text d’un TextRange pour retourner la représentation en texte brut d’un FlowDocumentspécifié.The following example demonstrates using the Text property of a TextRange to return the plain text representation of a specified 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 classe TextRange présente la terminologie suivante.The TextRange class introduces the following terminology.

  • Sélection : un TextRange est une sélection de contenu entre deux positions indiquée par TextPointer.Selection - A TextRange is a selection of content between two positions indicated by TextPointers. L’une de ces positions est une ancre fixe par rapport à la sélection, tandis que l’autre position est déplaçable.One of these positions a fixed anchor with respect to the selection, while the other position is movable. Cela est similaire à la façon dont une sélection est effectuée par un utilisateur à l’aide de la souris ou du clavier.This is similar to how a selection made by a user using the mouse or keyboard behaves.

  • Sélection actuelle : comme une TextRange indique toujours une sélection dans le contenu, il est logique de faire simplement référence à la sélection indiquée par une TextRange comme sélection actuelle.Current Selection - Because a TextRange always indicates a selection in content, it makes sense to simply refer to the selection indicated by a TextRange as the current selection.

  • Conteneur de texte : un conteneur de texte est l’élément qui forme la bordure finale du contenu dynamique. la sélection indiquée par un TextRange se trouve toujours dans un conteneur de texte.Text Container - A text container is the element that forms the ultimate border for the flow content at hand; the selection indicated by a TextRange always falls within a text container. À l’heure actuelle, un conteneur de texte doit être un FlowDocument ou un TextBlock.Currently, a text container must be either a FlowDocument or a TextBlock.

  • Document : le contenu rassemblé dans un conteneur de texte est désigné sous le terme de document.Document - The content collectively contained within a text container is referred to as a document.

Pour plus d’informations sur d’autres termes tels que la position, consultez TextPointer.For more information about other related terms like position, see 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.Initializes a new instance of the TextRange class, taking two specified TextPointer positions as the beginning and end positions for the new range.

Propriétés

End

Obtient la position qui marque l'extrémité de la sélection actuelle.Get the position that marks the end of the current selection.

IsEmpty

Obtient une valeur qui indique si la sélection actuelle est vide.Gets a value indicating whether or not the current selection is empty.

Start

Obtient la position qui marque le début de la sélection actuelle.Gets the position that marks the beginning of the current selection.

Text

Obtient ou définit le contenu en texte brut de la sélection actuelle.Gets or sets the plain text contents of the current selection.

Méthodes

ApplyPropertyValue(DependencyProperty, Object)

Applique une propriété et une valeur de mise en forme spécifiées à la sélection actuelle.Applies a specified formatting property and value to the current selection.

CanLoad(String)

Vérifie si du contenu peut être chargé dans la sélection actuelle à un format de données spécifié.Checks whether the current selection can be loaded with content in a specified data format.

CanSave(String)

Vérifie si la sélection actuelle peut être enregistrée à un format de données spécifié.Checks whether the current selection can be saved as a specified data format.

ClearAllProperties()

Supprime toutes les propriétés de mise en forme (représentées par des éléments Inline) de la sélection actuelle.Removes all formatting properties (represented by Inline elements) from the current selection.

Contains(TextPointer)

Vérifie si une position (spécifiée par un TextPointer) est située dans la sélection actuelle.Checks whether a position (specified by a TextPointer) is located within the current selection.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(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.Returns the effective value of a specified formatting property on the current selection.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(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é.Loads the current selection in a specified data format from a specified stream.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
Save(Stream, String)

Enregistre la sélection actuelle au format de données spécifié dans le flux indiqué.Saves the current selection to a specified stream in a specified data format.

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.Saves the current selection to a specified stream in a specified data format, with the option of preserving custom TextElement objects.

Select(TextPointer, TextPointer)

Met à jour la sélection actuelle et indique la sélection mise à jour à l'aide de deux positions de TextPointer.Updates the current selection, taking two TextPointer positions to indicate the updated selection.

ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)

Événements

Changed

Se produit lorsque la plage est repositionnée de façon à couvrir un nouvel intervalle du contenu.Occurs when the range is repositioned to cover a new span of content.

S’applique à

Voir aussi