UiaFind, fonction (uiautomationcoreapi.h)

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 un ou plusieurs nœuds UI Automation qui correspondent aux critères de recherche.

Syntaxe

HRESULT UiaFind(
  [in]  HUIANODE        hnode,
  [in]  UiaFindParams   *pParams,
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] SAFEARRAY       **ppOffsets,
  [out] SAFEARRAY       **ppTreeStructures
);

Paramètres

[in] hnode

Type : HUIANODE

Nœud à utiliser comme point de départ de la recherche.

[in] pParams

Type : UiaFindParams*

Adresse d’une structure UiaFindParams qui contient les paramètres de recherche.

[in] pRequest

Type : UiaCacheRequest*

Adresse d’une structure UiaCacheRequest qui spécifie les informations à mettre en cache.

[out] ppRequestedData

Type : SAFEARRAY**

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

[out] ppOffsets

Type : SAFEARRAY**

Adresse d’une variable qui reçoit un pointeur vers un SAFEARRAY contenant les index vers le tableau de données demandé pour l’endroit où commence la sous-arborescence de l’élément. Ce paramètre est passé sans être initialisé.

[out] ppTreeStructures

Type : SAFEARRAY**

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

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