Método IUIAutomationElement::FindFirstBuildCache (uiautomationclient.h)
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(
TreeScope scope,
[in] IUIAutomationCondition *condition,
[in] IUIAutomationCacheRequest *cacheRequest,
[out, retval] IUIAutomationElement **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: IUIAutomationElement**
Recebe um ponteiro para o elemento correspondente ou NULL se nenhum elemento correspondente for encontrado.
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
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 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 |
---|---|
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
Armazenando em cache Automação da Interface do Usuário propriedades e padrões de controle
Conceitual
Obtendo elementos da automação interface do usuário
Referência
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de