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

  • Article

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

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