Interface IUIAutomationTextRange (uiautomationclient.h)

Fournit l’accès à une étendue de texte continu dans un conteneur qui prend en charge l’interface IUIAutomationTextPattern . Les applications clientes peuvent utiliser l’interface IUIAutomationTextRange pour sélectionner, comparer et récupérer des objets incorporés à partir de l’étendue de texte. L’interface utilise deux points de terminaison pour délimiter l’endroit où l’étendue de texte commence et se termine. Les étendues de texte disjointes sont représentées par une interface IUIAutomationTextRangeArray .

Héritage

L’interface IUIAutomationTextRange hérite de l’interface IUnknown. IUIAutomationTextRange a également les types de membres suivants :

Méthodes

L’interface IUIAutomationTextRange utilise ces méthodes.

IUIAutomationTextRange::AddToSelection Ajoute la plage de texte à la collection de plages de texte sélectionnées dans un contrôle qui prend en charge plusieurs étendues disjointes de texte sélectionné. (IUIAutomationTextRange.AddToSelection)
IUIAutomationTextRange::Clone Récupère un nouvel IUIAutomationTextRange identique à l’original et héritant de toutes les propriétés de l’original.
IUIAutomationTextRange::Compare Récupère une valeur qui spécifie si cette plage de texte a les mêmes points de terminaison qu’une autre plage de texte. (IUIAutomationTextRange.Compare)
IUIAutomationTextRange::CompareEndpoints Récupère une valeur qui spécifie si le point de terminaison de début ou de fin de cette plage de texte est identique au point de terminaison de début ou de fin d’une autre plage de texte.
IUIAutomationTextRange::ExpandToEnclosingUnit Normalise la plage de texte par l’unité de texte spécifiée. La plage est étendue si elle est plus petite que l’unité spécifiée, ou raccourcie si elle est plus longue que l’unité spécifiée. (IUIAutomationTextRange.ExpandToEnclosingUnit)
IUIAutomationTextRange::FindAttribute Récupère un sous-ensemble de plage de texte qui a la valeur d’attribut de texte spécifiée.
IUIAutomationTextRange::FindText Récupère un sous-ensemble de plage de texte qui contient le texte spécifié.
IUIAutomationTextRange::GetAttributeValue Récupère la valeur de l’attribut de texte spécifié sur l’ensemble de la plage de texte.
IUIAutomationTextRange::GetBoundingRectangles Récupère une collection de rectangles englobants pour chaque ligne de texte complètement ou partiellement visible dans une plage de texte. (IUIAutomationTextRange.GetBoundingRectangles)
IUIAutomationTextRange::GetChildren Récupère une collection de tous les objets incorporés qui se trouvent dans la plage de texte. (IUIAutomationTextRange.GetChildren)
IUIAutomationTextRange::GetEnclosingElement Retourne l’élément UI Automation le plus interne qui entoure la plage de texte.
IUIAutomationTextRange::GetText Retourne le texte brut de la plage de texte.
IUIAutomationTextRange::Move Déplace la plage de texte vers l’avant ou vers l’arrière selon le nombre spécifié d’unités de texte .
IUIAutomationTextRange::MoveEndpointByRange Déplace un point de terminaison de la plage de texte actuelle vers le point de terminaison spécifié d’une deuxième plage de texte. (IUIAutomationTextRange.MoveEndpointByRange)
IUIAutomationTextRange::MoveEndpointByUnit Déplace un point de terminaison de la plage de texte du nombre spécifié d'unités de texte dans la plage de documents.
IUIAutomationTextRange::RemoveFromSelection Supprime la plage de texte d’une collection existante de texte sélectionné dans un conteneur de texte qui prend en charge plusieurs sélections disjointes.
IUIAutomationTextRange::ScrollIntoView Fait défiler le contrôle de texte jusqu’à ce que la plage de texte soit visible dans la fenêtre d’affichage.
IUIAutomationTextRange::Select Sélectionne l’étendue de texte qui correspond à cette plage de texte et supprime toute sélection précédente. (IUIAutomationTextRange.Select)

Configuration requise

Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista, Windows XP avec SP3 et Mise à jour de plateforme pour Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008, Windows Server 2003 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uiautomationclient.h (incluez UIAutomation.h)

Voir aussi

Interfaces de modèle de contrôle pour les clients

Prise en charge d’UI Automation pour le contenu textuel

Utilisation de plages de texte