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

Recupera o elemento ancestral mais próximo do elemento de Automação da Interface do Usuário da Microsoft especificado na exibição de árvore.

Sintaxe

HRESULT NormalizeElement(
  [in]          IUIAutomationElement *element,
  [out, retval] IUIAutomationElement **normalized
);

Parâmetros

[in] element

Tipo: IUIAutomationElement*

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

[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. Mas, primeiro, o elemento passado é testado para ver se corresponde a uma condição de normalização. Nesse caso, o elemento passado é retornado, mesmo que não seja um ancestral.

O método retornará UIA_E_ELEMENTNOTAVAILABLE se nenhum elemento correspondente tiver sido encontrado.

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::Normalize 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