UiaNodeFromPoint, fonction (uiautomationcoreapi.h)

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