IUIAutomationEventHandlerGroup::AddPropertyChangedEventHandler-Methode (uiautomationclient.h)

  • Artikel

Registriert eine Methode, die ein Eigenschaftsänderungsereignis verarbeitet.

Wichtig Microsoft Benutzeroberflächenautomatisierung-Clients sollten die Methoden der Handlergruppe verwenden, um Ereignislistener anstelle einzelner Ereignisregistrierungsmethoden zu registrieren, die in den verschiedenen IUIAutomation-Namespaces definiert sind.
 

Syntax

HRESULT AddPropertyChangedEventHandler(
       TreeScope                                scope,
  [in] IUIAutomationCacheRequest                *cacheRequest,
  [in] IUIAutomationPropertyChangedEventHandler *handler,
  [in] PROPERTYID                               *propertyArray,
       int                                      propertyCount
);

Parameter

scope

[in] cacheRequest

Ein Zeiger auf eine Cacheanforderung oder NULL , wenn keine Zwischenspeicherung gewünscht ist.

[in] handler

Ein Zeiger auf das -Objekt, das das -Ereignis behandelt.

[in] propertyArray

Ein Zeiger auf die Benutzeroberflächenautomatisierung interessanten Eigenschaften. Eine Liste der Eigenschaften-IDs finden Sie unter Eigenschaftenbezeichner.

propertyCount

Die Anzahl der überwachten Eigenschaften.

Rückgabewert

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

Hinweise

Bevor Sie einen Ereignishandler implementieren, sollten Sie mit den Threadingproblemen vertraut sein, die unter Grundlegendes zu Threadingproblemen beschrieben werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1809 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server, Version 1709 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile uiautomationclient.h (include UIAutomation.h)

Weitere Informationen

IUIAutomationEventHandlerGroup