Partager via


fonction TextPattern_RangeFromPoint (uiautomationcoreapi.h)

Note Cette fonction est déconseillée. Les applications clientes doivent utiliser les interfaces COM (Microsoft UI Automation Component Object Model) à la place.
 
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 TextPattern_RangeFromPoint(
  [in]  HUIAPATTERNOBJECT hobj,
  [in]  UiaPoint          point,
  [out] HUIATEXTRANGE     *pRetVal
);

Paramètres

[in] hobj

Type : HUIAPATTERNOBJECT

Objet de modèle de contrôle.

[in] point

Type : HiaPoint

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

[out] pRetVal

Type : HUIATEXTRANGE*

Lorsque cette fonction retourne, contient la plage de texte que le nœud couvre. Ce paramètre est passé sans être initialisé.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite ou une valeur d’erreur dans le cas contraire.

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.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête uiautomationcoreapi.h
Bibliothèque Uiautomationcore.lib
DLL Uiautomationcore.dll