TreeWalker.GetParent 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 parent de l’élément spécifié AutomationElement.
Surcharges
| Nom | Description |
|---|---|
| GetParent(AutomationElement) |
Récupère l’élément parent de l’élément spécifié AutomationElement. |
| GetParent(AutomationElement, CacheRequest) |
Récupère l’élément parent des propriétés et modèles spécifiés AutomationElement et met en cache les propriétés et les modèles. |
Remarques
La structure de l’arborescence AutomationElement change en tant qu’éléments d’interface utilisateur visibles sur le bureau. Il n’est pas garanti qu’un élément retourné en tant qu’élément parent sera retourné en tant que parent lors des passes ultérieures.
GetParent(AutomationElement)
Récupère l’élément parent de l’élément spécifié AutomationElement.
public:
System::Windows::Automation::AutomationElement ^ GetParent(System::Windows::Automation::AutomationElement ^ element);
public System.Windows.Automation.AutomationElement GetParent(System.Windows.Automation.AutomationElement element);
member this.GetParent : System.Windows.Automation.AutomationElement -> System.Windows.Automation.AutomationElement
Public Function GetParent (element As AutomationElement) As AutomationElement
Paramètres
- element
- AutomationElement
Élément dont le parent doit être retourné.
Retours
L’élément parent ou une référence null (Nothing dans Visual Basic) si l’élément spécifié est l’élément racine de l’arborescence ou si l’élément parent n’est pas visible dans l’affichage actuel.
Exemples
L’exemple suivant montre GetParent comment rechercher l’élément de fenêtre qui contient un élément spécifié.
/// <summary>
/// Retrieves the top-level window that contains the specified UI Automation element.
/// </summary>
/// <param name="element">The contained element.</param>
/// <returns>The containing top-level window element.</returns>
private AutomationElement GetTopLevelWindow(AutomationElement element)
{
TreeWalker walker = TreeWalker.ControlViewWalker;
AutomationElement elementParent;
AutomationElement node = element;
if (node == elementRoot) return node;
do
{
elementParent = walker.GetParent(node);
if (elementParent == AutomationElement.RootElement) break;
node = elementParent;
}
while (true);
return node;
}
''' <summary>
''' Retrieves the top-level window that contains the specified UI Automation element.
''' </summary>
''' <param name="element">The contained element.</param>
''' <returns>The containing top-level window element.</returns>
Private Function GetTopLevelWindow(ByVal element As AutomationElement) As AutomationElement
Dim walker As TreeWalker = TreeWalker.ControlViewWalker
Dim elementParent As AutomationElement
Dim node As AutomationElement = element
If node = elementRoot Then
Return node
End If
Do
elementParent = walker.GetParent(node)
If elementParent = AutomationElement.RootElement Then
Exit Do
End If
node = elementParent
Loop While True
Return node
End Function 'GetTopLevelWindow
End Class
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 à
GetParent(AutomationElement, CacheRequest)
Récupère l’élément parent des propriétés et modèles spécifiés AutomationElement et met en cache les propriétés et les modèles.
public:
System::Windows::Automation::AutomationElement ^ GetParent(System::Windows::Automation::AutomationElement ^ element, System::Windows::Automation::CacheRequest ^ request);
public System.Windows.Automation.AutomationElement GetParent(System.Windows.Automation.AutomationElement element, System.Windows.Automation.CacheRequest request);
member this.GetParent : System.Windows.Automation.AutomationElement * System.Windows.Automation.CacheRequest -> System.Windows.Automation.AutomationElement
Public Function GetParent (element As AutomationElement, request As CacheRequest) As AutomationElement
Paramètres
- element
- AutomationElement
Élément dont le parent doit être retourné.
- request
- CacheRequest
Objet de demande de cache spécifiant des membres sur le cache retourné AutomationElement .
Retours
L’élément parent ou une référence null (Nothing dans Visual Basic) si l’élément spécifié est l’élément racine de l’arborescence, ou si l’élément parent n’est pas visible dans cette vue.
Remarques
La structure de l’arborescence AutomationElement change en tant qu’éléments d’interface utilisateur visibles sur le bureau. Il n’est pas garanti qu’un élément retourné en tant qu’élément parent sera retourné en tant que parent lors des passes ultérieures.
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