Méthode IUIAutomationProxyFactoryEntry ::SetWinEventsForAutomationEvent (uiautomationclient.h)

Article
03/03/2024

Mappe les événements Microsoft UI Automation à WinEvents.

Syntaxe

HRESULT SetWinEventsForAutomationEvent(
  [in] EVENTID    eventId,
  [in] PROPERTYID propertyId,
  [in] SAFEARRAY  *winEvents
);

Paramètres

[in] eventId

Type : EVENTID

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

[in] propertyId

Type : PROPERTYID

Identificateur de la propriété. Pour obtenir la liste des ID de propriété, consultez Identificateurs de propriétés.

[in] winEvents

Type : SAFEARRAY*

Liste des événements WinEvent mappés à cet événement.

Valeur retournée

Type : HRESULT

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

Remarques

Lorsqu’une application cliente s’abonne à un événement UI Automation, le cœur UI Automation écoute également winEvents mappés à cet événement. Par exemple, supposons que UIA_Invoke_InvokedEventId soit mappé à EVENT_OBJECT_INVOKED. Lorsque EVENT_OBJECT_INVOKED est déclenché, le client instancie le proxy et appelle RespondToWinEvent sur ce proxy. Dans l’implémentation de RespondToWinEvent, le proxy appelle AddAutomationEvent. Le cœur déclenche ensuite l’événement UI Automation correspondant.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Platform Update pour Windows Vista, Windows XP avec SP3 et Platform Update pour Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008, Windows Server 2003 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uiautomationclient.h (incluez UIAutomation.h)

Voir aussi

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

Conceptuel

GetWinEventsForAutomationEvent

IUIAutomationProxyFactoryEntry

Référence

Partager via