Método IUIAutomation::GetRootElementBuildCache (uiautomationclient.h)

Recupera o elemento Automação da Interface do Usuário que representa a área de trabalho, pré-busca as propriedades solicitadas e os padrões de controle e armazena os itens pré-buscados no cache.

Sintaxe

HRESULT GetRootElementBuildCache(
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **root
);

Parâmetros

[in] cacheRequest

Tipo: IUIAutomationCacheRequest*

Um ponteiro para a solicitação de cache, que especifica as propriedades e os padrões de controle a serem armazenados no cache.

[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)

Confira também

IUIAutomation

IUIAutomation::GetRootElement