Metodo IUIAutomation4::AddChangesEventHandler (uiautomationclient.h)

Registra un metodo che gestisce gli eventi di modifica.

Sintassi

HRESULT AddChangesEventHandler(
  [in] IUIAutomationElement             *element,
  [in] TreeScope                        scope,
  [in] int                              *changeTypes,
  [in] int                              changesCount,
  [in] IUIAutomationCacheRequest        *pCacheRequest,
  [in] IUIAutomationChangesEventHandler *handler
);

Parametri

[in] element

Tipo: IUIAutomationElement*

Puntatore all'elemento di automazione interfaccia utente associato al gestore eventi.

[in] scope

Tipo: TreeScope

Ambito degli eventi da gestire; ovvero se si trovano sull'elemento stesso, o sui suoi predecessori e discendenti.

[in] changeTypes

Tipo: int*

Puntatore a un elenco di numeri interi che indicano i tipi di modifica rappresentato dall'evento.

[in] changesCount

Tipo: int

Numero di modifiche apportate in questo evento.

[in] pCacheRequest

Tipo: IUIAutomationCacheRequest*

Puntatore a una richiesta di cache o NULL se non si vuole memorizzare nella cache.

[in] handler

Tipo: IUIAutomationChangesEventHandler*

Puntatore all'oggetto che gestisce l'evento di modifica.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Osservazioni

Un client di Automazione interfaccia utente Microsoft non deve usare più thread per aggiungere o rimuovere gestori eventi. Un comportamento imprevisto può determinare se un gestore eventi viene aggiunto o rimosso mentre un altro viene aggiunto o rimosso nello stesso processo client.

Fabbisogno

Vedere anche

IUIAutomation4

RemoveAllEventHandlers