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

  • Article

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