Méthode ITextProvider ::RangeFromPoint (uiautomationcore.h)

  • Article

Retourne 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]          UiaPoint           point,
  [out, retval] ITextRangeProvider **pRetVal
);

Paramètres

[in] point

Type : UiaPoint

Emplacement dans les coordonnées d'écran.

[out, retval] pRetVal

Type : ITextRangeProvider**

Reçoit un pointeur vers la plage de texte dégénérée (vide) la plus proche de l’emplacement spécifié. 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

Une plage de texte qui entoure 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 ou d’un autre objet incorporé.

Étant donné que le texte masqué n’est pas ignoré par ITextProvider ::RangeFromPoint, une plage dégénérée du texte visible le plus proche du point donné est retournée.

La propriété ne retourne jamais NULL.

Configuration requise

Condition requise Valeur
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

Conceptuel

ITextProvider

ITextRangeProvider

Référence

Vue d'ensemble des fournisseurs UI Automation