TreeWalker.GetParent Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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
- Visão geral da árvore de automação de interface do usuário
- Navegar em elementos de automação de interface do usuário com TreeWalker
- Obtendo elementos da automação interface do usuário
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
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
- Visão geral da árvore de automação de interface do usuário
- Navegar em elementos de automação de interface do usuário com TreeWalker
- Obtendo elementos da automação interface do usuário