uiaNodeFromPoint 函数 (uiautomationcoreapi.h)

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

 

检索指定点处元素的UI 自动化节点。

语法

HRESULT UiaNodeFromPoint(
  [in]  double          x,
  [in]  double          y,
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] BSTR            *ppTreeStructure
);

参数

[in] x

类型： double

点的水平坐标。

[in] y

类型： double

点的垂直坐标。

[in] pRequest

类型： UiaCacheRequest*

UiaCacheRequest 结构的地址，该结构包含来自客户端的信息的缓存请求。

[out] ppRequestedData

类型： SAFEARRAY**

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

[out] ppTreeStructure

类型： BSTR*

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

返回值

类型： HRESULT

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

注解

返回的元素将是UI 自动化树结构中与指定条件匹配的最接近的元素。

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

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

要求

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