TreeWalker.Normalize Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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)
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 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
- Vue d’ensemble de l’arborescence UI Automation
- Naviguer entre les éléments UI Automation avec TreeWalker
- Obtention d'éléments UI Automation
S’applique à
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
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 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
- Vue d’ensemble de l’arborescence UI Automation
- Naviguer entre les éléments UI Automation avec TreeWalker
- Obtention d'éléments UI Automation