Funzione UiaAddEvent (uiautomationcoreapi.h)

Articolo
08/26/2023

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

Aggiunge un listener per gli eventi in un nodo nell'albero Automazione interfaccia utente.

Sintassi

HRESULT UiaAddEvent(
  [in]  HUIANODE         hnode,
  [in]  EVENTID          eventId,
  [in]  UiaEventCallback *pCallback,
  [in]  TreeScope        scope,
  [in]  PROPERTYID       *pProperties,
  [in]  int              cProperties,
  [in]  UiaCacheRequest  *pRequest,
  [out] HUIAEVENT        *phEvent
);

Parametri

[in] hnode

Tipo: HUIANODE

Nodo a cui aggiungere un listener eventi.

[in] eventId

Tipo: EVENTID

Identificatore dell'evento da ascoltare. Per un elenco di ID evento, vedere Identificatori di eventi.

[in] pCallback

Tipo: UiaEventCallback*

Indirizzo della funzione di callback uiaEventCallback definita dall'applicazione che viene chiamata quando viene generato l'evento.

[in] scope

Tipo: TreeScope*

Valore del tipo enumerato TreeScope che indica l'ambito degli eventi da gestire; ovvero, sia che si trovino sull'elemento stesso, o sui suoi predecessori e bambini.

[in] pProperties

Tipo: PROPERTYID*

Indirizzo di una matrice che contiene gli identificatori delle proprietà da monitorare per gli eventi di modifica, quando eventId è l'EVENTOD derivato da AutomationPropertyChanged_Event_GUID; in caso contrario, questo parametro è NULL. Per un elenco di ID proprietà, vedere Identificatori di proprietà.

[in] cProperties

Tipo: int

Numero di elementi nella matrice pProperties .

[in] pRequest

Tipo: UiaCacheRequest*

Indirizzo di una struttura UiaCacheRequest che definisce la richiesta di cache in effetti per i nodi restituiti con eventi.

[out] phEvent

Tipo: HUIEVENT*

Quando questa funzione restituisce, contiene un puntatore all'evento aggiunto. Questo parametro viene passato non inizializzato.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario.

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
Libreria	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Vedi anche

UiaLookupId

Condividi tramite