IUIAutomationEventHandlerGroup::AddPropertyChangedEventHandler-Methode (uiautomationclient.h)

Artikel
2024-08-08

Registriert eine Methode, die ein Eigenschaftsänderungsereignis behandelt.

Wichtige Microsoft-Benutzeroberflächenautomatisierungs-Clients sollten die Handlergruppenmethoden verwenden, um Ereignislistener anstelle einzelner Ereignisregistrierungsmethoden zu registrieren, die in den verschiedenen IUIAutomation Namespaces definiert sind.

Syntax

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

Parameter

[in] scope

Der Umfang der zu behandelnden Ereignisse; das heißt, ob sie sich auf dem Element selbst oder auf ihren Vorgängern und untergeordneten Elementen befinden.

[in] cacheRequest

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

[in] handler

Ein Zeiger auf das Objekt, das das Ereignis behandelt.

[in] propertyArray

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

propertyCount

Die Anzahl der überwachten Eigenschaften.

Rückgabewert

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

Bemerkungen

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 1809 [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server, Version 1709 [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	uiautomationclient.h (include UIAutomation.h)

Siehe auch

IUIAutomationEventHandlerGroup

Freigeben über