Metodo IUIAutomation6::AddEventHandlerGroup (uiautomationclient.h)

Articolo
03/09/2024

Registra una raccolta di metodi del gestore eventi specificati con IUIAutomation6::CreateEventHandlerGroup.

Importante

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

Sintassi

HRESULT AddEventHandlerGroup(
  [in] IUIAutomationElement           *element,
       IUIAutomationEventHandlerGroup *handlerGroup
);

Parametri

[in] element

Puntatore all'elemento Automazione interfaccia utente associato al gruppo del gestore eventi.

handlerGroup

Raccolta di listener eventi di Automazione interfaccia utente.

Valore restituito

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

Commenti

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

È possibile che un evento venga recapitato a un gestore eventi dopo la sottoscrizione del gestore, se l'evento viene ricevuto simultaneamente con la richiesta di annullare la sottoscrizione dell'evento. La procedura consigliata consiste nel seguire lo standard Component Object Model (COM) ed evitare di distruggere l'oggetto gestore eventi fino a quando il numero di riferimenti non ha raggiunto zero. L'eliminazione di un gestore eventi immediatamente dopo l'annullamento della sottoscrizione per gli eventi può causare una violazione di accesso se un evento viene recapitato in ritardo.

Requisiti

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	Windows
Intestazione	uiautomationclient.h (includere UIAutomation.h)

Vedi anche

Interfaccia IUIAutomation6::RemoveEventHandlerGroup, IUIAutomation6

Condividi tramite