Compartilhar via


TreeWalker.Normalize Método

Definição

Recupera o elemento ancestral mais próximo ao AutomationElement especificado no modo de exibição de árvore usado por esta instância de TreeWalker.

Sobrecargas

Normalize(AutomationElement)

Recupera o nó, se ele atender ao Condition ou o nó pai ou ancestral mais próximo ou que atenda ao Condition.

Normalize(AutomationElement, CacheRequest)

Recupera o nó, se ele atender ao Condition ou o nó pai ou ancestral mais próximo ou que atenda ao Condition e armazene em cache as propriedades e os padrões.

Comentários

O elemento é normalizado navegando até a cadeia ancestral na árvore até que um elemento que satisfaça a condição de exibição do TreeWalker objeto seja atingido. Se o elemento raiz for atingido, o elemento raiz será retornado mesmo que não atenda à condição de exibição.

Esse método é útil para aplicativos que obtêm referências a elementos Automação da Interface do Usuário por meio de testes de ocorrência. O aplicativo pode querer trabalhar apenas com tipos específicos de elementos e pode usar 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.

Normalize(AutomationElement)

Recupera o nó, se ele atender ao Condition ou o nó pai ou ancestral mais próximo ou que atenda ao Condition.

public:
 System::Windows::Automation::AutomationElement ^ Normalize(System::Windows::Automation::AutomationElement ^ element);
public System.Windows.Automation.AutomationElement Normalize (System.Windows.Automation.AutomationElement element);
member this.Normalize : System.Windows.Automation.AutomationElement -> System.Windows.Automation.AutomationElement
Public Function Normalize (element As AutomationElement) As AutomationElement

Parâmetros

element
AutomationElement

O elemento do qual iniciar a normalização.

Retornos

AutomationElement

O AutomationElement mais próximo na exibição atual. Se a navegação para cima na cadeia do ancestral chegar ao elemento raiz, o elemento raiz será retornado.

Comentários

O elemento é normalizado navegando até a cadeia ancestral na árvore até que um elemento que satisfaça a condição de exibição do TreeWalker objeto seja atingido. Se o elemento raiz for atingido, o elemento raiz será retornado mesmo que não atenda à condição de exibição.

Esse método é útil para aplicativos que obtêm referências a elementos Automação da Interface do Usuário por meio de testes de ocorrência. O aplicativo pode querer trabalhar apenas com tipos específicos de elementos e pode usar 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.

Confira também

Aplica-se a

Normalize(AutomationElement, CacheRequest)

Recupera o nó, se ele atender ao Condition ou o nó pai ou ancestral mais próximo ou que atenda ao Condition e armazene em cache as propriedades e os padrões.

public:
 System::Windows::Automation::AutomationElement ^ Normalize(System::Windows::Automation::AutomationElement ^ element, System::Windows::Automation::CacheRequest ^ request);
public System.Windows.Automation.AutomationElement Normalize (System.Windows.Automation.AutomationElement element, System.Windows.Automation.CacheRequest request);
member this.Normalize : System.Windows.Automation.AutomationElement * System.Windows.Automation.CacheRequest -> System.Windows.Automation.AutomationElement
Public Function Normalize (element As AutomationElement, request As CacheRequest) As AutomationElement

Parâmetros

element
AutomationElement

O elemento do qual iniciar a normalização.

request
CacheRequest

Um objeto de solicitação de cache que especifica propriedades e padrões no AutomationElement retornado ao cache.

Retornos

AutomationElement

O AutomationElement mais próximo na exibição atual. Se a navegação para cima na cadeia do ancestral chegar ao elemento raiz, o elemento raiz será retornado.

Comentários

O elemento é normalizado navegando até a cadeia ancestral na árvore até que um elemento que satisfaça a condição de exibição do TreeWalker objeto seja atingido. Se o elemento raiz for atingido, o elemento raiz será retornado mesmo que não atenda à condição de exibição.

Esse método é útil para aplicativos que obtêm referências a elementos Automação da Interface do Usuário por meio de testes de ocorrência. O aplicativo pode querer trabalhar apenas com tipos específicos de elementos e pode usar 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.

Confira também

Aplica-se a