IUIAutomationTextPattern ::RangeFromPoint, méthode (uiautomationclient.h)

Récupère la plage de texte dégénérée (vide) la plus proche des coordonnées d’écran spécifiées.

Syntaxe

HRESULT RangeFromPoint(
  [in]          POINT                  pt,
  [out, retval] IUIAutomationTextRange **range
);

Paramètres

[in] pt

Type : POINT

Structure qui contient l’emplacement, dans les coordonnées de l’écran.

[out, retval] range

Type : IUIAutomationTextRange**

Reçoit un pointeur vers la plage de texte dégénérée la plus proche de l’emplacement spécifié.

Valeur retournée

Type : HRESULT

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

Remarques

Une plage de texte qui encapsule un objet enfant est retournée si les coordonnées de l’écran se trouvent dans les coordonnées d’une image, d’un lien hypertexte, d’une feuille de calcul Microsoft Excel ou d’un autre objet incorporé.

Étant donné que le texte masqué n’est pas ignoré, cette méthode récupère une plage dégénérée à partir du texte visible le plus proche des coordonnées spécifiées.

L’implémentation de RangeFromPoint dans Windows Internet Explorer 9 ne retourne pas le résultat attendu. Au lieu de cela, les clients doivent :

1. Appelez la méthode GetVisibleRanges pour récupérer un tableau de plages de texte visibles.
2. Pour chaque plage de texte dans le tableau, appelez IUIAutomationTextRange ::GetBoundingRectangles pour récupérer les rectangles englobants.
3. Vérifiez les rectangles englobants pour rechercher la plage de texte qui occupe les coordonnées d’écran particulières.

Configuration requise

Voir aussi

IUIAutomationTextPattern

UI Automation prise en charge du contenu textuel