IUIAutomation5::AddNotificationEventHandler-Methode (uiautomationclient.h)

Registriert eine Methode, die Benachrichtigungsereignisse behandelt.

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

 

Syntax

HRESULT AddNotificationEventHandler(
  [in] IUIAutomationElement                  *element,
  [in] TreeScope                             scope,
  [in] IUIAutomationCacheRequest             *cacheRequest,
  [in] IUIAutomationNotificationEventHandler *handler
);

Parameter

[in] element

Typ: IUIAutomationElement*

Ein Zeiger auf das Benutzeroberflächenautomatisierungs-Element, das dem Ereignishandler zugeordnet ist.

[in] scope

Typ: TreeScope-

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

[in] cacheRequest

Typ: IUIAutomationCacheRequest*

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

[in] handler

Typ: IUIAutomationNotificationEventHandler*

Ein Zeiger auf das Objekt, das das Benachrichtigungsereignis behandelt.

Rückgabewert

Typ: HRESULT-

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

Anforderungen

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

Siehe auch

IUIAutomation5-

RemoveAllEventHandlers-