Share via

IUIAutomation4：：AddChangesEventHandler 方法 (uiautomationclient.h)

  • 项目

注册处理更改事件的方法。

注意 在实现事件处理程序之前，应熟悉了解线程问题中所述 的线程问题。
 

语法

HRESULT AddChangesEventHandler(
  [in] IUIAutomationElement             *element,
       TreeScope                        scope,
  [in] int                              *changeTypes,
  [in] int                              changesCount,
  [in] IUIAutomationCacheRequest        *pCacheRequest,
  [in] IUIAutomationChangesEventHandler *handler
);

参数

[in] element

类型： IUIAutomationElement*

指向与事件处理程序关联的 UI 自动化 元素的指针。

scope

[in] changeTypes

类型： int*

指向整数列表的指针，指示事件表示的更改类型。

[in] changesCount

类型： int

此事件中发生的更改数。

[in] pCacheRequest

类型： IUIAutomationCacheRequest*

指向缓存请求的指针;如果不需要缓存，则为 NULL 。

[in] handler

类型： IUIAutomationChangesEventHandler*

指向处理更改事件的 对象的指针。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

Microsoft UI 自动化客户端不应使用多个线程来添加或删除事件处理程序。 如果在同一客户端进程中添加或删除另一个事件处理程序，则会导致意外行为。

要求

要求 值
最低受支持的客户端 Windows 10版本 1607 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
目标平台 Windows
标头 uiautomationclient.h (包括 UIAutomation.h)

另请参阅

IUIAutomation4

RemoveAllEventHandlers