Funzione UiaAddEvent (uiautomationcoreapi.h)

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

Vedi anche

UiaLookupId