Método IUIAutomation::GetRootElement (uiautomationclient.h)
Recupera o elemento Automação da Interface do Usuário que representa a área de trabalho.
Sintaxe
HRESULT GetRootElement(
[out, retval] IUIAutomationElement **root
);
Parâmetros
[out, retval] root
Tipo: IUIAutomationElement**
Recebe um ponteiro para o elemento Automação da Interface do Usuário.
Retornar valor
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Você pode usar o elemento raiz como ponto de partida para localizar outros elementos, usando os métodos FindAll e FindFirst .
Ao pesquisar no elemento raiz, especifique TreeScope_Children no escopo da pesquisa, não TreeScope_Descendants. Uma pesquisa por toda a subárvore da área de trabalho poderia iterar por milhares de itens e levar a um estouro de pilha.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista, Windows XP com SP3 e Atualização de Plataforma para Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008, Windows Server 2003 com SP2 e Atualização de Plataforma para Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | uiautomationclient.h (inclua UIAutomation.h) |