Metodo IUIAutomationEventHandlerGroup::AddChangesEventHandler (uiautomationclient.h)

Articolo
08/08/2024

Registra un metodo che gestisce gli eventi di modifica.

Importante i client di Automazione interfaccia utente Microsoft devono usare i metodi del gruppo di gestori per registrare i listener di eventi anziché i singoli metodi di registrazione eventi definiti nei vari spazi dei nomi IUIAutomation.

Sintassi

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

Parametri

[in] scope

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

[in] changeTypes

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

[in] changesCount

Numero di modifiche apportate in questo evento.

[in] cacheRequest

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

[in] handler

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

Valore restituito

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

Osservazioni

Prima di implementare un gestore eventi, è necessario avere familiarità con i problemi di threading descritti in Informazioni sui problemi di threading.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 1809 [solo app desktop]
server minimo supportato	Windows Server, versione 1709 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	uiautomationclient.h (include UIAutomation.h)

Vedere anche

IUIAutomationEventHandlerGroup

Condividi tramite