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

Artigo
08/08/2024

Localiza o primeiro elemento correspondente na ordem especificada, mas também armazena em cache suas propriedades e padrão.

Sintaxe

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

Parâmetros

[in] scope

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

[in] condition

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

[in] cacheRequest

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

traversalOptions

Valor de enumeração que especifica a ordem de navegação da árvore.

[in, optional] root

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

[out, retval] found

Recebe um ponteiro para o elemento. NULL será retornado se nenhum elemento correspondente for encontrado.

Valor de retorno

Retorna S_OK se bem-sucedido, caso contrário, um hresult código de erro.

Requisitos

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

Consulte também

IUIAutomationElement7

Compartilhar via