/// <summary>
/// Return the element or the nearest ancestor which is present in
/// the view of the tree used by this treewalker, prefetching properties
/// for the returned node
/// </summary>
/// <param name="element">element to normalize</param>
/// <param name="request">CacheRequest specifying information to be prefetched</param>
/// <returns>The element or the nearest ancestor which satisfies the
/// condition used by this TreeWalker</returns>
/// <remarks>
/// This method starts at the specified element and walks up the
/// tree until it finds an element that satisfies the TreeWalker's
/// condition.
///
/// If the passed-in element itself satsifies the condition, it is
/// returned as-is.
///
/// If the process of walking up the tree hits the root node, then
/// the root node is returned, regardless of whether it satisfies
/// the condition or not.
/// </remarks>
public AutomationElement Normalize(AutomationElement element, CacheRequest request)
{
Misc.ValidateArgumentNonNull(element, "element");
Misc.ValidateArgumentNonNull(request, "request");
return(element.Normalize(_condition, request));
}
/// <summary>
/// Return the element or the nearest ancestor which is present in
/// the view of the tree used by this treewalker, prefetching properties
/// for the returned node
/// </summary>
/// <param name="element">element to normalize</param>
/// <param name="request">CacheRequest specifying information to be prefetched</param>
/// <returns>The element or the nearest ancestor which satisfies the
/// condition used by this TreeWalker</returns>
/// <remarks>
/// This method starts at the specified element and walks up the
/// tree until it finds an element that satisfies the TreeWalker's
/// condition.
///
/// If the passed-in element itself satsifies the condition, it is
/// returned as-is.
///
/// If the process of walking up the tree hits the root node, then
/// the root node is returned, regardless of whether it satisfies
/// the condition or not.
/// </remarks>
public AutomationElement Normalize(AutomationElement element, CacheRequest request)
{
Misc.ValidateArgumentNonNull(element, "element");
Misc.ValidateArgumentNonNull(request, "request");
return element.Normalize(_condition, request);
}
/// <summary>
/// Return the element or the nearest ancestor which is present in
/// the view of the tree used by this treewalker
/// </summary>
/// <param name="element">element to normalize</param>
/// <returns>The element or the nearest ancestor which satisfies the
/// condition used by this TreeWalker</returns>
/// <remarks>
/// This method starts at the specified element and walks up the
/// tree until it finds an element that satisfies the TreeWalker's
/// condition.
///
/// If the passed-in element itself satsifies the condition, it is
/// returned as-is.
///
/// If the process of walking up the tree hits the root node, then
/// the root node is returned, regardless of whether it satisfies
/// the condition or not.
/// </remarks>
public AutomationElement Normalize(AutomationElement element)
{
Misc.ValidateArgumentNonNull(element, "element");
return(element.Normalize(_condition, null));
}
/// <summary>
/// Return the element or the nearest ancestor which is present in
/// the view of the tree used by this treewalker
/// </summary>
/// <param name="element">element to normalize</param>
/// <returns>The element or the nearest ancestor which satisfies the
/// condition used by this TreeWalker</returns>
/// <remarks>
/// This method starts at the specified element and walks up the
/// tree until it finds an element that satisfies the TreeWalker's
/// condition.
///
/// If the passed-in element itself satsifies the condition, it is
/// returned as-is.
///
/// If the process of walking up the tree hits the root node, then
/// the root node is returned, regardless of whether it satisfies
/// the condition or not.
/// </remarks>
public AutomationElement Normalize(AutomationElement element)
{
Misc.ValidateArgumentNonNull(element, "element");
return element.Normalize(_condition, null);
}
