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

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

Important

Les clients Microsoft UI Automation doivent utiliser les méthodes de groupe de gestionnaires pour inscrire des écouteurs d’événements au lieu des méthodes d’inscription d’événements individuelles définies dans les différents espaces de noms de l’interface IUIAutomation.

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

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1809 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server, version 1709 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uiautomationclient.h (incluez UIAutomation.h)

Voir aussi

IUIAutomation6 ::RemoveEventHandlerGroup, interface IUIAutomation6