IUIAutomationEventHandlerGroup::AddPropertyChangedEventHandler 方法(uiautomationclient.h)

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

重要 Microsoft UI 自动化客户端应使用处理程序组方法来注册事件侦听器,而不是在各种 IUIAutomation 命名空间中定义的单个事件注册方法。
 

语法

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

参数

[in] scope

要处理的事件的范围;也就是说,无论是在元素本身上,还是在元素的祖先和子元素上。

[in] cacheRequest

指向缓存请求的指针;如果没有缓存,则 NULL

[in] handler

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

[in] propertyArray

指向感兴趣的 UI 自动化属性的指针。 有关属性 ID 的列表,请参阅 属性标识符

propertyCount

正在监视的属性数。

返回值

如果此方法成功,则返回 S_OK。 否则,它将返回 HRESULT 错误代码。

言论

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

要求

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

另请参阅

IUIAutomationEventHandlerGroup