ITextProvider::GetVisibleRanges, méthode (uiautomationcore.h)

Article
08/26/2023

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] SAFEARRAY **pRetVal
);

Paramètres

[out, retval] pRetVal

Type : SAFEARRAY**

Reçoit l’adresse d’un tableau de pointeurs vers les interfaces ITextRangeProvider des plages de texte visibles ou d’un tableau vide. Une référence NULL n’est jamais retournée. Ce paramètre est passé sans être initialisé.

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 pRetVal doit contenir une seule plage de texte qui représente tout le texte visible.

Si le texte visible se compose de plusieurs étendues de texte disjointes, le tableau pRetVal doit contenir une plage de texte pour chaque étendue visible, commençant par la première étendue visible et se terminant par la dernière étendue visible. Des étendues de texte visible disjointes 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 avec plusieurs pages ou colonnes a du contenu partiellement affiché.

ITextProvider::GetVisibleRanges doit retourner une plage de texte dégénérée (vide) si aucun texte n’est visible, si tout le texte est défilé en dehors de la vue ou si le contrôle textuel ne contient aucun texte.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	uiautomationcore.h (incluez UIAutomation.h)