UiaEventCallback 回调函数 (uiautomationcoreapi.h)

  • 项目
注意 此函数已弃用。 客户端应用程序应改用 Microsoft UI 自动化组件对象模型 (COM) 接口。
 
一个客户端实现的函数，在引发客户端已订阅的事件时由 UI 自动化调用。

语法

UiaEventCallback Uiaeventcallback;

void Uiaeventcallback(
  [in] UiaEventArgs *pArgs,
  [in] SAFEARRAY *pRequestedData,
  [in] BSTR pTreeStructure
)
{...}

参数

[in] pArgs

类型： UiaEventArgs*

包含事件参数的 UiaEventArgs 结构的地址。

[in] pRequestedData

类型： SAFEARRAY*

包含与事件关联的数据的 SAFEARRAY 。

[in] pTreeStructure

类型： BSTR

一个字符串，包含与事件关联的树结构（如果该事件与一组节点相关联）。 请参阅“备注”。

返回值

无

备注

此函数将传递给 UiaAddEvent 和 UiaRemoveEvent。

树结构由字符串描述，其中每个字符都是“p”或“) ”。 字符串中的第一个字符始终表示根节点。 如果函数未返回任何元素，则字符串为 NULL 。

“p”表示) UI 自动化元素 (节点。 当一个“p”直接紧跟另一个“p”时，第二个节点是第一个节点的子节点。 “) ”表示逐步备份树。 例如，“pp) p”表示一个节点，后跟两个彼此同级节点的子节点。 在“pp) ) p”中，最后一个节点是第一个节点的同级节点。

要求

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