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

Artigo
08/08/2024

Recupera o primeiro elemento filho ou descendente que corresponde à condição especificada, pré-busca as propriedades solicitadas e os padrões de controle e armazena os itens pré-buscados no cache.

Sintaxe

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

Parâmetros

[in] scope

Tipo: TreeScope

Uma combinação de valores que especificam o escopo da pesquisa.

[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ídas no cache.

[out, retval] found

Tipo: ** IUIAutomationElement

Recebe um ponteiro para o elemento correspondente ou NULL se nenhum elemento correspondente for encontrado.

Valor de retorno

Tipo: HRESULT

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Observações

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 procurar 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 escopo parâmetro, não TreeScope_Descendants. Uma pesquisa por toda a subárvore da área de trabalho poderia iterar por meio de 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.

Para pesquisar a árvore bruta, especifique o TreeScope apropriado no parâmetro cacheRequest .

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 7, Windows Vista com SP2 e Platform Update para Windows Vista, Windows XP com SP3 e Platform Update para Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008, Windows Server 2003 com SP2 e Platform Update para Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	uiautomationclient.h (include UIAutomation.h)