UiaAddEvent 函数 (uiautomationcoreapi.h)

  • 项目
注意 此函数已弃用。 客户端应用程序应改用 Microsoft UI 自动化组件对象模型 (COM) 接口。
 
为 UI 自动化树中的节点上的事件添加侦听器。

语法

HRESULT UiaAddEvent(
  [in]  HUIANODE         hnode,
  [in]  EVENTID          eventId,
  [in]  UiaEventCallback *pCallback,
  [in]  TreeScope        scope,
  [in]  PROPERTYID       *pProperties,
  [in]  int              cProperties,
  [in]  UiaCacheRequest  *pRequest,
  [out] HUIAEVENT        *phEvent
);

参数

[in] hnode

类型： HUIANODE

要向其添加事件侦听器的节点。

[in] eventId

类型： EVENTID

要侦听的事件的标识符。 有关事件 ID 的列表，请参阅 事件标识符。

[in] pCallback

类型： UiaEventCallback*

引发事件时调用的应用程序定义的 UiaEventCallback 回调函数的地址。

[in] scope

类型： TreeScope*

TreeScope 枚举类型的值，指示要处理的事件的范围;也就是说，无论它们位于 元素本身上，还是在其上级和子元素上。

[in] pProperties

类型： PROPERTYID*

当 eventId 是派生自 AutomationPropertyChanged_Event_GUID 的 EVENTID 时，包含要监视更改事件的属性标识符的数组的地址;否则此参数为 NULL。 有关属性 ID 的列表，请参阅 属性标识符。

[in] cProperties

类型： int

pProperties 数组中的元素计数。

[in] pRequest

类型： UiaCacheRequest*

UiaCacheRequest 结构的地址，该结构定义对随事件一起返回的节点有效的缓存请求。

[out] phEvent

类型： HUIEVENT*

当此函数返回时，包含指向所添加事件的指针。 此参数未经初始化即被传递。

返回值

类型： HRESULT

如果成功，则返回S_OK，否则返回错误值。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 uiautomationcoreapi.h
Library Uiautomationcore.lib
DLL Uiautomationcore.dll

另请参阅

UiaLookupId