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 de celui spécifié AutomationElement dans l’arborescence utilisée par cette instance de TreeWalker.
Surcharges
| Nom | Description |
|---|---|
| Normalize(AutomationElement) |
Récupère le nœud lui-même, s’il satisfait au Conditionnœud , ou au nœud parent ou ancêtre le plus proche qui satisfait le Condition. |
| Normalize(AutomationElement, CacheRequest) |
Récupère le nœud lui-même, s’il satisfait au Conditionnœud parent ou ancêtre le plus proche qui satisfait aux Conditionpropriétés et aux 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 à des é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 démarrer la normalisation.
Retours
Le plus AutomationElement proche dans l’affichage actuel. Si la navigation vers le haut de la chaîne ancêtre atteint l’élément racine, l’élément racine 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 à des é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 de l’automatisation de l’interface utilisateur
- Naviguer parmi les éléments UI Automation avec TreeWalker
- Obtaining UI Automation Elements
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 démarrer la normalisation.
- request
- CacheRequest
Objet de demande de cache spécifiant des propriétés et des modèles sur le cache retourné AutomationElement .
Retours
Le plus AutomationElement proche dans l’affichage actuel. Si la navigation vers le haut de la chaîne ancêtre atteint l’élément racine, l’élément racine 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 à des é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 de l’automatisation de l’interface utilisateur
- Naviguer parmi les éléments UI Automation avec TreeWalker
- Obtaining UI Automation Elements