Método IUIAutomationTreeWalker::NormalizeElementBuildCache (uiautomationclient.h)

Recupera o elemento ancestral mais próximo do elemento de Automação da Interface do Usuário da Microsoft especificado no modo de exibição de árvore, pré-busca as propriedades solicitadas e os padrões de controle e armazena os itens pré-buscados no cache.

Sintaxe

HRESULT NormalizeElementBuildCache(
  [in]          IUIAutomationElement      *element,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **normalized
);

Parâmetros

[in] element

Tipo: IUIAutomationElement*

Um ponteiro para o elemento do qual iniciar a normalização.

[in] cacheRequest

Tipo: IUIAutomationCacheRequest*

Um ponteiro para uma solicitação de cache que especifica as propriedades e os padrões de controle a serem armazenados em cache no elemento retornado.

[out, retval] normalized

Tipo: IUIAutomationElement**

Recebe um ponteiro para o elemento ancestral mais próximo do elemento especificado na exibição de árvore.

Valor retornado

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 elemento é normalizado navegando até a cadeia ancestral na árvore até que um elemento que atenda à condição de exibição (especificado por uma chamada anterior para IUIAutomationTreeWalker::Condition) seja atingido. Se o elemento raiz for atingido, o elemento raiz será retornado, mesmo que ele não atenda à condição de exibição.

Esse método é útil para aplicativos que obtêm referências a elementos da Automação da Interface do Usuário por meio de teste de ocorrência. O aplicativo pode querer trabalhar apenas com tipos específicos de elementos e pode usar IUIAutomationTreeWalker::NormalizeElement para garantir que não importa qual elemento seja recuperado inicialmente (por exemplo, quando uma barra de rolagem obtém o foco de entrada), apenas o elemento de interesse (como um elemento de conteúdo) é recuperado.

Requisitos