Méthode IRawElementProviderAdviseEvents ::AdviseEventAdded (uiautomationcore.h)

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é.

Syntaxe

HRESULT AdviseEventAdded(
  [in] EVENTID   eventId,
  [in] SAFEARRAY *propertyIDs
);

Paramètres

[in] eventId

Type : EVENTID

Identificateur de l’événement ajouté. Pour obtenir la liste des ID d’événement, consultez Identificateurs d’événements.

[in] propertyIDs

Type : SAFEARRAY*

Pointeur vers les identificateurs des propriétés ajoutées, ou NULL si l’écouteur d’événements ajouté n’écoute pas les événements de propriété.

Valeur retournée

Type : HRESULT

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

Remarques

Cette méthode permet au fournisseur de réduire la surcharge en activant uniquement les événements qui sont écoutés.

Il est important pour UI Automation fournisseurs de traiter IRawElementProviderAdviseEvents ::AdviseEventAdded comme la méthode AddRef 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

Voir aussi

Meilleures pratiques pour l’utilisation de tableaux sécurisés

Conceptuel

IRawElementProviderAdviseEvents

Référence