TreeWalker.Normalize Méthode

Définition

Récupère l'élément ancêtre le plus proche du AutomationElement spécifié dans l'arborescence utilisée par cette instance de TreeWalker.

Surcharges

Normalize(AutomationElement)

Récupère le nœud lui-même, s'il satisfait Condition, ou le nœud parent ou ancêtre le plus proche qui satisfait Condition.

Normalize(AutomationElement, CacheRequest)

Récupère le nœud lui-même, s'il satisfait Condition, ou le nœud parent ou ancêtre le plus proche qui satisfait Condition, et met en cache les propriétés et les modèles.

Remarques

L’élément est normalisé en parcourant la chaîne ancêtre dans l’arborescence jusqu’à ce qu’un élément répondant à la condition d’affichage de l’objet TreeWalker soit atteint. Si l’élément racine est atteint, l’élément racine est retourné même s’il ne satisfait pas à la condition d’affichage.

Cette méthode est utile pour les applications qui obtiennent des références aux éléments UI Automation en effectuant des tests de positionnement. L’application peut vouloir fonctionner uniquement avec des types spécifiques d’éléments et peut être utilisée Normalize pour s’assurer que quel que soit l’élément initialement récupéré (par exemple, lorsqu’une barre de défilement obtient le focus d’entrée), seul l’élément d’intérêt (tel qu’un élément de contenu) est finalement récupéré.

Normalize(AutomationElement)

Récupère le nœud lui-même, s'il satisfait Condition, ou le nœud parent ou ancêtre le plus proche qui satisfait 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

Paramètres

element
AutomationElement

Élément à partir duquel commencer la normalisation.

Retours

AutomationElement

AutomationElement le plus proche dans l'affichage actuel. Si la navigation vers le haut dans la chaîne ancêtre atteint l'élément racine, ce dernier est retourné.

Remarques

L’élément est normalisé en parcourant la chaîne ancêtre dans l’arborescence jusqu’à ce qu’un élément répondant à la condition d’affichage de l’objet TreeWalker soit atteint. Si l’élément racine est atteint, l’élément racine est retourné même s’il ne satisfait pas à la condition d’affichage.

Cette méthode est utile pour les applications qui obtiennent des références aux éléments UI Automation en effectuant des tests de positionnement. L’application peut vouloir fonctionner uniquement avec des types spécifiques d’éléments et peut être utilisée Normalize pour s’assurer que quel que soit l’élément initialement récupéré (par exemple, lorsqu’une barre de défilement obtient le focus d’entrée), seul l’élément d’intérêt (tel qu’un élément de contenu) est finalement récupéré.

Voir aussi

S’applique à

Normalize(AutomationElement, CacheRequest)

Récupère le nœud lui-même, s'il satisfait Condition, ou le nœud parent ou ancêtre le plus proche qui satisfait Condition, et met en cache les propriétés et les modèles.

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

Paramètres

element
AutomationElement

Élément à partir duquel commencer la normalisation.

request
CacheRequest

Objet de requête de cache spécifiant les propriétés et les modèles sur le AutomationElement à mettre en cache.

Retours

AutomationElement

AutomationElement le plus proche dans l'affichage actuel. Si la navigation vers le haut dans la chaîne ancêtre atteint l'élément racine, ce dernier est retourné.

Remarques

L’élément est normalisé en parcourant la chaîne ancêtre dans l’arborescence jusqu’à ce qu’un élément répondant à la condition d’affichage de l’objet TreeWalker soit atteint. Si l’élément racine est atteint, l’élément racine est retourné même s’il ne satisfait pas à la condition d’affichage.

Cette méthode est utile pour les applications qui obtiennent des références aux éléments UI Automation en effectuant des tests de positionnement. L’application peut vouloir fonctionner uniquement avec des types spécifiques d’éléments et peut être utilisée Normalize pour s’assurer que quel que soit l’élément initialement récupéré (par exemple, lorsqu’une barre de défilement obtient le focus d’entrée), seul l’élément d’intérêt (tel qu’un élément de contenu) est finalement récupéré.

Voir aussi

S’applique à