Método IUIAutomationElement::FindAllBuildCache (uiautomationclient.h)

Artigo
08/26/2023

Retorna todos os elementos da Automação da Interface do Usuário que atendem à condição especificada, pré-busca as propriedades solicitadas e os padrões de controle e armazena os itens pré-buscados no cache.

Sintaxe

HRESULT FindAllBuildCache(
                TreeScope                 scope,
  [in]          IUIAutomationCondition    *condition,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElementArray **found
);

Parâmetros

scope

[in] condition

Tipo: IUIAutomationCondition*

Um ponteiro para uma condição que representa os critérios a serem correspondidos.

[in] cacheRequest

Tipo: IUIAutomationCacheRequest*

Um ponteiro para uma solicitação de cache que especifica os padrões de controle e as propriedades a serem incluídos no cache.

[out, retval] found

Tipo: IUIAutomationElementArray**

Recebe um ponteiro para uma matriz de elementos correspondentes. Se não houver correspondências, NULL será retornado.

Valor retornado

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

O escopo da pesquisa é relativo ao elemento no qual o método é chamado. Os elementos são retornados na ordem em que foram encontrados na árvore.

Essa função não pode pesquisar elementos ancestrais na árvore de Automação da Interface do Usuário da Microsoft; ou seja, TreeScope_Ancestors não é um valor válido para o parâmetro de escopo .

Ao pesquisar janelas de nível superior na área de trabalho, especifique TreeScope_Children no parâmetro de escopo , 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.

Se o aplicativo cliente tentar encontrar elementos em sua própria interface do usuário, você deverá fazer todas as chamadas de Automação da Interface do Usuário em um thread separado.

Requisitos


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)