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) |