UiaNodeFromFocus, fonction (uiautomationcoreapi.h)

Syntaxe

HRESULT UiaNodeFromFocus(
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] BSTR            *ppTreeStructure
);

Paramètres

[in] pRequest

Type : UiaCacheRequest*

Adresse d’une structure UiaCacheRequest qui contient des informations sur les données à mettre en cache.

[out] ppRequestedData

Type : SAFEARRAY**

Adresse d’une variable qui reçoit un pointeur vers un SAFEARRAY qui contient les informations 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’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