Langue

TreeWalker.GetParent Méthode

Définition

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

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

S’applique à