Méthode IUIAutomation6 ::AddEventHandlerGroup (uiautomationclient.h)

Inscrit une collection de méthodes de gestionnaire d’événements spécifiées avec IUIAutomation6 ::CreateEventHandlerGroup.

Syntaxe

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

Paramètres

[in] element

Pointeur vers l’élément UI Automation associé au groupe de gestionnaires d’événements.

handlerGroup

Collection d’écouteurs d’événements UI Automation.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Avant d’implémenter un gestionnaire d’événements, vous devez être familiarisé avec les problèmes de thread décrits dans Présentation des problèmes liés aux threads.

Il est possible qu’un événement soit remis à un gestionnaire d’événements une fois que le gestionnaire a été désinscrit, si l’événement est reçu simultanément avec la demande d’annulation de l’événement. La meilleure pratique consiste à suivre la norme COM (Component Object Model) et à éviter de détruire l’objet gestionnaire d’événements jusqu’à ce que son nombre de références ait atteint zéro. La destruction d’un gestionnaire d’événements immédiatement après la désinscripation des événements peut entraîner une violation d’accès si un événement est remis en retard.

Configuration requise

Voir aussi

IUIAutomation6 ::RemoveEventHandlerGroup, interface IUIAutomation6