UiaNodeFromPoint, fonction (uiautomationcoreapi.h)

Article
03/03/2024

Note Cette fonction est déconseillée. Les applications clientes doivent utiliser les interfaces COM (Component Object Model) Microsoft UI Automation à la place.

Récupère le nœud UI Automation de l’élément au point spécifié.

Syntaxe

HRESULT UiaNodeFromPoint(
  [in]  double          x,
  [in]  double          y,
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] BSTR            *ppTreeStructure
);

Paramètres

[in] x

Type : double

Coordonnée horizontale du point.

[in] y

Type : double

Coordonnée verticale du point.

[in] pRequest

Type : UiaCacheRequest*

Adresse d’une structure UiaCacheRequest qui contient la demande de cache pour obtenir des informations du client.

[out] ppRequestedData

Type : SAFEARRAY**

Adresse d’une variable qui reçoit un pointeur vers un SAFEARRAY qui contient les données demandées. Ce paramètre est passé sans être initialisé.

[out] ppTreeStructure

Type : BSTR*

Adresse d’une variable qui reçoit la description de l’arborescence. Ce paramètre est passé sans être initialisé. Consultez la section Notes.

Valeur de retour

Type : HRESULT

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

Remarques

L’élément retourné sera l’élément le plus proche de l’arborescence UI Automation qui correspond aux critères spécifiés.

L’arborescence est décrite par une chaîne où chaque caractère est « p » ou « ». Le premier caractère de la chaîne représente toujours le nœud racine. La chaîne est NULL si aucun élément n’est retourné par la fonction .

Un « p » représente un nœud (élément UI Automation). Lorsqu’un « p » suit directement un autre, le deuxième nœud est un enfant du premier. Un « ) représente un pas en arrière dans l’arborescence. Par exemple, « pp)p » représente un nœud suivi de deux nœuds enfants qui sont frères l’un de l’autre. Dans « pp))p », le dernier nœud est un frère du premier.

Configuration requise

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

Share via