Compartilhar via


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

Localiza o primeiro elemento correspondente na ordem especificada.

Sintaxe

HRESULT FindFirstWithOptions(
  [in]           TreeScope              scope,
  [in]           IUIAutomationCondition *condition,
                 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.

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