Compartilhar via


TreeWalker.GetParent Método

Definição

Recupera o elemento pai do AutomationElement especificado.

Sobrecargas

GetParent(AutomationElement)

Recupera o elemento pai do AutomationElement especificado.

GetParent(AutomationElement, CacheRequest)

Recupera o elemento pai do AutomationElement especificado e armazena em cache as propriedades e os padrões.

Comentários

A estrutura da AutomationElement árvore muda à medida que os elementos de interface do usuário (interface do usuário) visíveis na área de trabalho mudam. Não é garantido que um elemento retornado como o elemento pai será retornado como o pai em passagens subsequentes.

GetParent(AutomationElement)

Recupera o elemento pai do AutomationElement especificado.

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

Parâmetros

element
AutomationElement

O elemento cujo pai será retornado.

Retornos

AutomationElement

O elemento pai ou uma referência nula (Nothing no Visual Basic) se o elemento especificado for o elemento raiz na árvore ou se o elemento pai não estiver visível na exibição atual.

Exemplos

O exemplo a seguir mostra GetParent como ser usado para localizar o elemento de janela que contém um elemento especificado.

/// <summary>
/// Retrieves the top-level window that contains the specified UI Automation element.
/// </summary>
/// <param name="element">The contained element.</param>
/// <returns>The containing top-level window element.</returns>
private AutomationElement GetTopLevelWindow(AutomationElement element)
{
    TreeWalker walker = TreeWalker.ControlViewWalker;
    AutomationElement elementParent;
    AutomationElement node = element;
    if (node == elementRoot) return node;
    do
    {
        elementParent = walker.GetParent(node);
        if (elementParent == AutomationElement.RootElement) break;
        node = elementParent;
    }
    while (true);
    return node;
}
    ''' <summary>
    ''' Retrieves the top-level window that contains the specified UI Automation element.
    ''' </summary>
    ''' <param name="element">The contained element.</param>
    ''' <returns>The containing top-level window element.</returns>
    Private Function GetTopLevelWindow(ByVal element As AutomationElement) As AutomationElement 
        Dim walker As TreeWalker = TreeWalker.ControlViewWalker
        Dim elementParent As AutomationElement
        Dim node As AutomationElement = element
        If node = elementRoot Then
            Return node
        End If
        Do
            elementParent = walker.GetParent(node)
            If elementParent = AutomationElement.RootElement Then
                Exit Do
            End If
            node = elementParent
        Loop While True
        Return node
    
    End Function 'GetTopLevelWindow
End Class

Confira também

Aplica-se a

GetParent(AutomationElement, CacheRequest)

Recupera o elemento pai do AutomationElement especificado e armazena em cache as propriedades e os padrões.

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

Parâmetros

element
AutomationElement

O elemento cujo pai será retornado.

request
CacheRequest

Um objeto de solicitação de cache que especifica membros no AutomationElement retornado ao cache.

Retornos

AutomationElement

O elemento pai ou uma referência nula (Nothing no Visual Basic) se o elemento especificado for o elemento raiz na árvore ou se o elemento pai não estiver visível nesta exibição.

Comentários

A estrutura da AutomationElement árvore muda à medida que os elementos de interface do usuário (interface do usuário) visíveis na área de trabalho mudam. Não é garantido que um elemento retornado como o elemento pai será retornado como o pai em passagens subsequentes.

Confira também

Aplica-se a