IUIAutomation5::AddNotificationEventHandler method (uiautomationclient.h)

Registers a method that handles notification events.

Note  Before implementing an event handler, you should be familiar with the threading issues described in Understanding Threading Issues.
 

Syntax

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

Parameters

[in] element

Type: IUIAutomationElement*

A pointer to the UI Automation element associated with the event handler.

[in] scope

Type: TreeScope

The scope of events to be handled; that is, whether they are on the element itself, or on its ancestors and descendants.

[in] cacheRequest

Type: IUIAutomationCacheRequest*

A pointer to a cache request, or NULL if no caching is wanted.

[in] handler

Type: IUIAutomationNotificationEventHandler*

A pointer to the object that handles the notification event.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1709 [desktop apps only]
Minimum supported server Windows Server, version 1709 [desktop apps only]
Target Platform Windows
Header uiautomationclient.h (include UIAutomation.h)

See also

IUIAutomation5

RemoveAllEventHandlers