Share via

Interface IRawElementProviderAdviseEvents (uiautomationcore.h)

  • Article

Expose les méthodes appelées pour notifier l’élément racine d’un fragment lorsqu’une application cliente Microsoft UI Automation commence ou se termine à l’écoute des événements sur ce fragment.

Héritage

L’interface IRawElementProviderAdviseEvents hérite de l’interface IUnknown. IRawElementProviderAdviseEvents a également les types de membres suivants :

Méthodes

L’interface IRawElementProviderAdviseEvents a ces méthodes.

 
IRawElementProviderAdviseEvents ::AdviseEventAdded

Avertit le fournisseur microsoft UI Automation lorsqu’un client UI Automation commence à écouter un événement spécifique, y compris un événement de modification de propriété.
IRawElementProviderAdviseEvents ::AdviseEventRemoved

Avertit le fournisseur microsoft UI Automation lorsqu’un client UI Automation cesse d’écouter un événement spécifique, y compris un événement de modification de propriété.

Remarques

L’implémentation de cette interface est facultative. Il peut être utilisé pour améliorer les performances en mettant en place des événements uniquement lorsqu’ils sont écoutés.

À l’instar de l’implémentation du comptage de références dans la programmation COM (Component Object Model), il est important pour les fournisseurs UI Automation de traiter les méthodes AdviseEventAdded et AdviseEventRemoved telles que les méthodes AddRef et Release de l’interface IUnknown. Tant qu’AdviseEventAdded a été appelé plus de fois qu’AdviseEventRemoved pour un événement ou une propriété spécifique, le fournisseur doit continuer à déclencher les événements correspondants, car certains clients sont toujours à l’écoute. Les fournisseurs UI Automation peuvent également utiliser la fonction UiaClientsAreListening pour déterminer si au moins un client écoute et, le cas échéant, déclencher tous les événements appropriés.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête uiautomationcore.h (incluez UIAutomation.h)