Funzione di callback uiaEventCallback (uiautomationcoreapi.h)

Articolo
03/08/2023

Nota Questa funzione è deprecata. Le applicazioni client devono usare invece le interfacce Microsoft Automazione interfaccia utente Component Object Model (COM).

Funzione implementata dal client chiamata da Automazione interfaccia utente quando viene generato un evento a cui il client ha sottoscritto.

Sintassi

UiaEventCallback Uiaeventcallback;

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

Parametri

[in] pArgs

Tipo: UiaEventArgs*

Indirizzo di una struttura UiaEventArgs contenente gli argomenti dell'evento.

[in] pRequestedData

Tipo: SAFEARRAY*

SAFEARRAY che contiene dati associati all'evento.

[in] pTreeStructure

Tipo: BSTR

Stringa che contiene la struttura dell'albero associata all'evento, se l'evento è associato a un set di nodi. Vedere la sezione Osservazioni.

Valore restituito

nessuno

Osservazioni

Questa funzione viene passata a UiaAddEvent e UiaRemoveEvent.

La struttura ad albero è descritta da una stringa in cui ogni carattere è "p" o ")". Il primo carattere nella stringa rappresenta sempre il nodo radice. La stringa è NULL se non vengono restituiti elementi dalla funzione.

Un elemento "p" rappresenta un nodo (elemento Automazione interfaccia utente). Quando una "p" segue direttamente un'altra, il secondo nodo è un elemento figlio del primo. Un ")" rappresenta un passaggio di backup dell'albero. Ad esempio, "pp)p" rappresenta un nodo seguito da due nodi figlio che sono fratelli tra loro. In "pp))p", l'ultimo nodo è un fratello del primo.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiautomationcoreapi.h

Condividi tramite