IUIAutomationProxyFactoryEntry::SetWinEventsForAutomationEvent-Methode (uiautomationclient.h)

  • Artikel

Ordnet Microsoft Benutzeroberflächenautomatisierung-Ereignisse WinEvents zu.

Syntax

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

Parameter

[in] eventId

Typ: EVENTID

Der Ereignisbezeichner. Eine Liste der Ereignisbezeichner finden Sie unter Ereignisbezeichner.

[in] propertyId

Typ: PROPERTYID

Der Eigenschaftenbezeichner. Eine Liste der Eigenschaften-IDs finden Sie unter Eigenschaftenbezeichner.

[in] winEvents

Typ: SAFEARRAY*

Die Liste der WinEvents, die diesem Ereignis zugeordnet sind.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn eine Clientanwendung ein Benutzeroberflächenautomatisierung-Ereignis abonniert, lauscht der Benutzeroberflächenautomatisierung Kern auch auf WinEvents, die diesem Ereignis zugeordnet sind. Angenommen, UIA_Invoke_InvokedEventId ist EVENT_OBJECT_INVOKED zugeordnet. Wenn EVENT_OBJECT_INVOKED ausgelöst wird, instanziiert der Client den Proxy und ruft RespondToWinEvent für diesen Proxy auf. In der Implementierung von RespondToWinEvent ruft der Proxy AddAutomationEvent auf. Der Kern löst dann das entsprechende Benutzeroberflächenautomatisierung-Ereignis aus.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista, Windows XP mit SP3 und Plattformupdate für Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008, Windows Server 2003 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile uiautomationclient.h (include UIAutomation.h)

Weitere Informationen

Bewährte Methoden für die Verwendung sicherer Arrays

Konzept

GetWinEventsForAutomationEvent

IUIAutomationProxyFactoryEntry

Referenz