UiaNodeFromFocus 函数 (uiautomationcoreapi.h)

注意此函数已弃用。客户端应用程序应改用 Microsoft UI 自动化组件对象模型 (COM) 接口。

检索当前具有输入焦点的 UI 元素的UI 自动化节点。

语法

HRESULT UiaNodeFromFocus(
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] BSTR            *ppTreeStructure
);

[in] pRequest

UiaCacheRequest 结构的地址，该结构包含有关要缓存的数据的信息。

[out] ppRequestedData

类型： SAFEARRAY**

接收指向包含所请求信息的 SAFEARRAY 的指针的变量的地址。此参数未经初始化即被传递。

[out] ppTreeStructure

类型： BSTR*

接收树结构说明的变量的地址。此参数未经初始化即被传递。请参阅“备注”。

类型： HRESULT

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

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

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