Fonction de rappel UiaEventCallback (uiautomationcoreapi.h)

Article
08/26/2023

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

Fonction implémentée par le client appelée par UI Automation lorsqu’un événement auquel le client s’est abonné est déclenché.

Syntaxe

UiaEventCallback Uiaeventcallback;

void Uiaeventcallback(
  [in] UiaEventArgs *pArgs,
  [in] SAFEARRAY *pRequestedData,
  [in] BSTR pTreeStructure
)
{...}

Paramètres

[in] pArgs

Type : UiaEventArgs*

Adresse d’une structure UiaEventArgs qui contient les arguments d’événement.

[in] pRequestedData

Type : SAFEARRAY*

SAFEARRAY qui contient les données associées à l’événement.

[in] pTreeStructure

Type : BSTR

Chaîne qui contient la structure de l’arborescence associée à l’événement, si l’événement est associé à un ensemble de nœuds. Consultez la section Notes.

Valeur de retour

None

Remarques

Cette fonction est passée à UiaAddEvent et UiaRemoveEvent.

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


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

Partager via