Méthode IUIAutomationTextPattern ::GetVisibleRanges (uiautomationclient.h)

  • Article

Récupère un tableau de plages de texte disjointes à partir d’un contrôle textuel où chaque plage de texte représente une étendue contiguë de texte visible.

Syntaxe

HRESULT GetVisibleRanges(
  [out, retval] IUIAutomationTextRangeArray **ranges
);

Paramètres

[out, retval] ranges

Type : IUIAutomationTextRangeArray**

Reçoit un pointeur vers la collection de plages de texte visibles dans le contrôle textuel.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Si le texte visible se compose d’une étendue de texte contiguë, le tableau de plages contient une seule plage de texte qui représente l’ensemble du texte visible.

Si le texte visible se compose de plusieurs étendues de texte disjointes, le tableau de plages contient une plage de texte pour chaque étendue visible, en commençant par la première étendue visible et se terminant par la dernière étendue visible. Des étendues disjointes de texte visible peuvent se produire lorsque le contenu d’un contrôle textuel est partiellement masqué par une fenêtre ou un autre objet qui se chevauche, ou lorsqu’un contrôle textuel comportant plusieurs pages ou colonnes a du contenu qui est partiellement affiché.

IUIAutomationTextPattern ::GetVisibleRanges récupère une plage de texte dégénérée (vide) si aucun texte n’est visible, si tout le texte est fait défiler hors d’affichage ou si le contrôle textuel ne contient aucun texte.

Configuration requise

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

Voir aussi

IUIAutomationTextPattern

UI Automation prise en charge du contenu textuel