TreeWalker.Normalize Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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)
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
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
- Visão geral da árvore de automação de interface do usuário
- Navegar em elementos de automação de interface do usuário com TreeWalker
- Obtendo elementos da automação interface do usuário
Aplica-se a
Normalize(AutomationElement, CacheRequest)
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
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
- Visão geral da árvore de automação de interface do usuário
- Navegar em elementos de automação de interface do usuário com TreeWalker
- Obtendo elementos da automação interface do usuário