通过

UiaNavigate 函数 (uiautomationcoreapi.h)

  • 项目
注意 此函数已弃用。 客户端应用程序应改用 Microsoft UI 自动化 组件对象模型 (COM) 接口。
 
在UI 自动化树中导航，可以选择检索缓存的信息。

语法

HRESULT UiaNavigate(
  [in]  HUIANODE          hnode,
  [in]  NavigateDirection direction,
  [in]  UiaCondition      *pCondition,
  [in]  UiaCacheRequest   *pRequest,
  [out] SAFEARRAY         **ppRequestedData,
  [out] BSTR              *ppTreeStructure
);

参数

[in] hnode

类型： HUIANODE

导航开始的元素。

[in] direction

类型： NavigateDirection

NavigateDirection 枚举类型的值，指示从 hnode 导航的方向。

[in] pCondition

类型： UiaCondition*

UiaCondition 结构的地址，该结构指定要导航到的元素必须匹配的条件。 使用此参数可跳过不感兴趣的元素。

[in] pRequest

类型： UiaCacheRequest*

UiaCacheRequest 结构的地址，该结构包含要缓存的信息的说明。

[out] ppRequestedData

类型： SAFEARRAY**

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

[out] ppTreeStructure

类型： BSTR*

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

返回值

类型： HRESULT

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

注解

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

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

要求

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