通过

IUIAutomationTreeWalker：：NormalizeElementBuildCache 方法 (uiautomationclient.h)

  • 项目

检索树视图中离指定 Microsoft UI 自动化元素最近的上级元素，预提取请求的属性和控件模式，并将预提取的项存储在缓存中。

语法

HRESULT NormalizeElementBuildCache(
  [in]          IUIAutomationElement      *element,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **normalized
);

参数

[in] element

类型： IUIAutomationElement*

指向从中开始规范化的元素的指针。

[in] cacheRequest

类型： IUIAutomationCacheRequest*

指向缓存请求的指针，该请求指定要在返回的元素上缓存的属性和控件模式。

[out, retval] normalized

类型： IUIAutomationElement**

接收指向最接近树视图中指定元素的上级元素的指针。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

通过向上导航树中的上级链来规范化元素，直到达到之前调用 IUIAutomationTreeWalker：：Condition) 指定的满足视图条件的元素 (。 如果到达根元素，则返回根元素，即使它不满足视图条件。

此方法适用于通过命中测试获取对 UI 自动化元素的引用的应用程序。 应用程序可能只希望处理特定类型的元素，并且可以使用 IUIAutomationTreeWalker：：NormalizeElement 来确保无论最初检索到什么元素 (，例如，当滚动条) 获取输入焦点时，最终只会检索感兴趣的 (元素，如内容元素) 。

要求

   
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新、带 SP3 的 Windows XP 和适用于 Windows Vista 的平台更新 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008、Windows Server 2003 SP2 和 Platform Update for Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 uiautomationclient.h (包括 UIAutomation.h)