IUIAutomationProxyFactoryEntry::SetWinEventsForAutomationEvent, méthode (uiautomationclient.h)

  • Article
  • 2 minutes de lecture

Mappe les événements Microsoft UI Automation aux événements 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énement, consultez Identificateurs d’événement.

[in] propertyId

Type : PROPERTYID

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

[in] winEvents

Type : SAFEARRAY*

Liste des WinEvents qui correspondent à 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 .

Notes

Lorsqu’une application cliente s’abonne à un événement UI Automation, le UI Automation cœur écoute également les événements WinEvent qui mappent à 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 de UI Automation correspondant.

Configuration requise

   
Client minimal pris en charge Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista, Windows XP avec SP3 et Mise à jour de plateforme 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 (inclure UIAutomation.h)

Voir aussi

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

Conceptuel

GetWinEventsForAutomationEvent

IUIAutomationProxyFactoryEntry

Référence