通过

TreeWalker.Normalize 方法

  • 参考

定义

命名空间:
System.Windows.Automation
程序集:
UIAutomationClient.dll

在 AutomationElement 的此实例所使用的树视图中检索与指定的 TreeWalker 最接近的上级元素。

重载

Normalize(AutomationElement)

检索节点本身（如果它满足 Condition）或者检索满足 Condition 的最接近的父级或上级节点。
Normalize(AutomationElement, CacheRequest)

检索节点本身（如果它满足 Condition）或者检索满足 Condition 的最接近的父级或上级节点，并缓存属性和模式。

注解

通过导航树中的上级链来规范化该元素，直到达到该对象的视图条件的 TreeWalker 元素为止。 如果到达根元素，即使根元素不满足视图条件，也会返回根元素。

此方法对于通过命中测试获取对UI 自动化元素的引用的应用程序非常有用。 应用程序可能只想使用特定类型的元素，并且可用于 Normalize 确保无论最初检索到哪个元素 (，当滚动条获取输入焦点) 时，最终只检索感兴趣的元素 (，例如内容元素) 。

Normalize(AutomationElement)

检索节点本身（如果它满足 Condition）或者检索满足 Condition 的最接近的父级或上级节点。

public:
 System::Windows::Automation::AutomationElement ^ Normalize(System::Windows::Automation::AutomationElement ^ element);
public System.Windows.Automation.AutomationElement Normalize (System.Windows.Automation.AutomationElement element);
member this.Normalize : System.Windows.Automation.AutomationElement -> System.Windows.Automation.AutomationElement
Public Function Normalize (element As AutomationElement) As AutomationElement

参数

element
AutomationElement

从其开始规范化的元素。

返回

AutomationElement

当前视图中最接近的 AutomationElement。 如果沿上级链向上导航到达根元素，将返回根元素。

注解

通过导航树中的上级链来规范化该元素，直到达到该对象的视图条件的 TreeWalker 元素为止。 如果到达根元素，即使根元素不满足视图条件，也会返回根元素。

此方法对于通过命中测试获取对UI 自动化元素的引用的应用程序非常有用。 应用程序可能只想使用特定类型的元素，并且可用于 Normalize 确保无论最初检索到哪个元素 (，当滚动条获取输入焦点) 时，最终只检索感兴趣的元素 (，例如内容元素) 。

另请参阅

适用于

Normalize(AutomationElement, CacheRequest)

检索节点本身（如果它满足 Condition）或者检索满足 Condition 的最接近的父级或上级节点，并缓存属性和模式。

public:
 System::Windows::Automation::AutomationElement ^ Normalize(System::Windows::Automation::AutomationElement ^ element, System::Windows::Automation::CacheRequest ^ request);
public System.Windows.Automation.AutomationElement Normalize (System.Windows.Automation.AutomationElement element, System.Windows.Automation.CacheRequest request);
member this.Normalize : System.Windows.Automation.AutomationElement * System.Windows.Automation.CacheRequest -> System.Windows.Automation.AutomationElement
Public Function Normalize (element As AutomationElement, request As CacheRequest) As AutomationElement

参数

element
AutomationElement

从其开始规范化的元素。

request
CacheRequest

一个缓存请求对象，它指定返回的 AutomationElement 上要进行缓存的属性和模式。

返回

AutomationElement

当前视图中最接近的 AutomationElement。 如果沿上级链向上导航到达根元素，将返回根元素。

注解

通过导航树中的上级链来规范化该元素，直到达到该对象的视图条件的 TreeWalker 元素为止。 如果到达根元素，即使根元素不满足视图条件，也会返回根元素。

此方法对于通过命中测试获取对UI 自动化元素的引用的应用程序非常有用。 应用程序可能只想使用特定类型的元素，并且可用于 Normalize 确保无论最初检索到哪个元素 (，当滚动条获取输入焦点) 时，最终只检索感兴趣的元素 (，例如内容元素) 。

另请参阅

适用于