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

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

Voir aussi

IUIAutomationTextPattern

UI Automation prise en charge du contenu textuel