IUIAutomationTreeWalker：：NormalizeElement 方法 (uiautomationclient.h)

检索树视图中最靠近指定 Microsoft UI 自动化元素的上级元素。

语法

HRESULT NormalizeElement(
  [in]          IUIAutomationElement *element,
  [out, retval] IUIAutomationElement **normalized
);

参数

[in] element

类型： IUIAutomationElement*

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

[out, retval] normalized

类型： IUIAutomationElement**

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

返回值

类型： HRESULT

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

注解

元素通过向上导航树中的上级链进行规范化，直到达到之前对 IUIAutomationTreeWalker：：Condition) 调用所指定的视图条件 (元素。 但首先，测试传递的元素，看它是否与规范化条件匹配。 如果是这样，则返回传递的元素，即使它不是上级元素。

如果未找到 匹配元素 ，则方法返回UIA_E_ELEMENTNOTAVAILABLE。

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

要求

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