Método IUIAutomationElement7::FindAllWithOptionsBuildCache (uiautomationclient.h)

Artigo
03/03/2024

Localiza todos os elementos correspondentes na ordem especificada, mas também armazena em cache suas propriedades e padrões.

Sintaxe

HRESULT FindAllWithOptionsBuildCache(
  [in]          TreeScope                 scope,
  [in]          IUIAutomationCondition    *condition,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [in]          TreeTraversalOptions      traversalOptions,
  [in]          IUIAutomationElement      *root,
  [out, retval] IUIAutomationElementArray **found
);

Parâmetros

[in] scope

Tipo: TreeScope

O escopo da solicitação.

Quando um elemento é recuperado, o cache pode ser executado apenas para o próprio elemento (o comportamento padrão) ou para o elemento e seus filhos ou descendentes. Essa propriedade descreve o escopo da solicitação.

[in] condition

Tipo: IUIAutomationCondition

A interface primária para condições usadas na filtragem ao pesquisar elementos na árvore Automação da Interface do Usuário.

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

[in] traversalOptions

Tipo: TreeTraversalOptions

A ordem de navegação da árvore.

[in] root

Tipo: IUIAutomationElement

Um ponteiro para o elemento com o qual iniciar a pesquisa.

[out, retval] found

Recebe um ponteiro para uma matriz de elementos correspondentes. Retornará uma matriz vazia se nenhum elemento correspondente for encontrado.

Retornar valor

Retorna S_OK se tiver êxito, caso contrário, um código de erro HRESULT .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1703 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	uiautomationclient.h (include UIAutomation.h)
DLL	UIAutomationCore.dll

Confira também

IUIAutomationElement7

Compartilhar via