ITextRange Interface

Définition

Espace de noms:

Windows.UI.Text

Représente une étendue de texte continu dans un document et fournit des propriétés et des méthodes puissantes d’édition et de liaison de données qui permettent à une application de sélectionner, d’examiner et de modifier le texte du document.

public interface class ITextRange

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1537101399, 49266, 17056, 137, 69, 175, 80, 62, 229, 71, 104)]
struct ITextRange

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(1537101399, 49266, 17056, 137, 69, 175, 80, 62, 229, 71, 104)]
public interface ITextRange

Public Interface ITextRange

Dérivé

Windows.UI.Text.ITextSelection

Windows.UI.Text.RichEditTextRange

Attributs

ContractVersionAttribute GuidAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Propriétés

Character	Obtient ou définit le premier caractère de la plage de texte ; c’est-à-dire le caractère associé à la propriété StartPosition .
CharacterFormat	Obtient ou définit les attributs de mise en forme de caractères de la plage de texte.
EndPosition	Obtient ou définit la position du caractère de fin de la plage de texte.
FormattedText	Obtient ou définit un objet ITextRange avec le texte mis en forme de la plage spécifiée.
Gravity	Obtient ou définit la gravité de la plage de texte.
Length	Obtient le nombre de caractères dans la plage de texte.
Link	Obtient ou définit le texte d’URL associé à une plage de texte.
ParagraphFormat	Obtient ou définit les attributs de mise en forme de paragraphe de la plage de texte.
StartPosition	Obtient ou définit la position de début de la plage de texte.
StoryLength	Obtient le nombre de caractères dans l’histoire de la plage de texte.
Text	Obtient ou définit le texte brut de la plage de texte.

Méthodes

CanPaste(Int32)	Détermine si le Presse-papiers contient du contenu qui peut être collé, à l’aide d’un format spécifié, dans la plage de texte actuelle.
ChangeCase(LetterCase)	Modifie la casse des lettres dans une plage de texte.
Collapse(Boolean)	Réduit la plage de texte en un point dégénéré au début ou à la fin de la plage.
Copy()	Copie le texte de la plage de texte dans le Presse-papiers.
Cut()	Déplace le texte de la plage de texte dans le Presse-papiers.
Delete(TextRangeUnit, Int32)	Supprime le texte de la plage de texte.
EndOf(TextRangeUnit, Boolean)	Déplace ou étend la plage de texte jusqu’à la fin de l’unité de texte spécifiée la plus proche. La plage de texte est déplacée ou étendue vers l’avant dans le document.
Expand(TextRangeUnit)	Développe une plage de texte pour qu’elle contienne entièrement toutes les unités de texte partielles.
FindText(String, Int32, FindOptions)	Recherche une chaîne de texte particulière dans une plage et, si elle est trouvée, sélectionne la chaîne.
GetCharacterUtf32(UInt32, Int32)	Récupère le code de 32 caractères UTF (Unicode Transformation Format) du caractère au décalage spécifié à partir de la fin de la plage de texte.
GetClone()	Crée un objet identique à cet objet de plage de texte.
GetIndex(TextRangeUnit)	Récupère l’index de l’histoire de l’unité de texte (mot, ligne, phrase, paragraphe, etc.) à la position de caractère de départ de la plage de texte.
GetPoint(HorizontalCharacterAlignment, VerticalCharacterAlignment, PointOptions, Point)	Récupère les coordonnées d’écran d’un emplacement particulier dans la plage de texte.
GetRect(PointOptions, Rect, Int32)	Récupère le rectangle englobant qui englobe la plage de texte à l’écran.
GetText(TextGetOptions, String)	Récupère le texte dans une plage de texte en fonction des indicateurs de conversion spécifiés.
GetTextViaStream(TextGetOptions, IRandomAccessStream)	Récupère le texte dans la plage de texte en fonction des indicateurs de conversion spécifiés, sous la forme d’un flux d’accès aléatoire.
InRange(ITextRange)	Détermine si cette plage se trouve dans ou dans le même texte qu’une plage spécifiée.
InsertImage(Int32, Int32, Int32, VerticalCharacterAlignment, String, IRandomAccessStream)	Insère une image dans cette plage.
InStory(ITextRange)	Détermine si l’histoire de cette plage est identique à l’histoire d’une plage spécifiée.
IsEqual(ITextRange)	Détermine si cette plage a les mêmes positions de caractères et l’histoire que celles d’une plage spécifiée.
MatchSelection()	Définit les positions de début et de fin de cette plage pour qu’elles correspondent à la sélection active.
Move(TextRangeUnit, Int32)	Déplace le point d’insertion vers l’avant ou vers l’arrière selon le nombre d’unités spécifié. Si la plage de texte n’est pas dégénérée, elle est réduite à un point d’insertion à la position de début ou de fin de la plage de texte, en fonction du nombre, puis est déplacée.
MoveEnd(TextRangeUnit, Int32)	Déplace la position de fin de la plage de texte.
MoveStart(TextRangeUnit, Int32)	Déplace la position de début d’une plage de texte.
Paste(Int32)	Colle le texte du Presse-papiers dans la plage de texte.
ScrollIntoView(PointOptions)	Fait défiler cette plage de texte dans l’affichage.
SetIndex(TextRangeUnit, Int32, Boolean)	Déplace la plage de texte vers l’unité spécifiée de l’article.
SetPoint(Point, PointOptions, Boolean)	Modifie la plage de texte en fonction du point spécifié.
SetRange(Int32, Int32)	Définit les points de terminaison de la plage de texte sur les valeurs spécifiées.
SetText(TextSetOptions, String)	Remplace le texte dans la plage de texte.
SetTextViaStream(TextSetOptions, IRandomAccessStream)	Définit le texte de la plage de texte en fonction du contenu d’un flux d’accès aléatoire.
StartOf(TextRangeUnit, Boolean)	Déplace ou étend la plage de texte au début de l’unité de texte spécifiée la plus proche. La plage de texte est déplacée ou étendue vers l’arrière dans le document.