ITextProvider::GetVisibleRanges, méthode (uiautomationcore.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] 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) |
Voir aussi
Meilleures pratiques pour l’utilisation de tableaux sécurisés
Conceptuel
Référence