Partager via


TreeWalker.GetParent Méthode

Définition

Récupère l'élément parent du AutomationElement spécifié.

Surcharges

GetParent(AutomationElement)

Récupère l'élément parent du AutomationElement spécifié.

GetParent(AutomationElement, CacheRequest)

Récupère l'élément parent du AutomationElement spécifié et met en cache les propriétés et les modèles.

Remarques

La structure de l’arborescence AutomationElement change à mesure que les éléments d’interface utilisateur visibles sur le bureau changent. Il n’est pas garanti qu’un élément retourné en tant qu’élément parent soit retourné en tant que parent lors des passes suivantes.

GetParent(AutomationElement)

Récupère l'élément parent du AutomationElement spécifié.

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ément parent, ou référence null (Nothing en Visual Basic) si l’élément spécifié est l’élément racine dans l’arborescence, ou si l’élément parent n’est pas visible dans l’affichage actuel.

Exemples

L’exemple suivant montre GetParent comment être utilisé pour rechercher l’élément window 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 du AutomationElement spécifié 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 requête de cache spécifiant les membres sur le AutomationElement retourné à mettre en cache.

Retours

Élément parent, ou référence null (Nothing en Visual Basic) si l’élément spécifié est l’élément racine dans l’arborescence, ou si l’élément parent n’est pas visible dans cet affichage.

Remarques

La structure de l’arborescence AutomationElement change à mesure que les éléments d’interface utilisateur visibles sur le bureau changent. Il n’est pas garanti qu’un élément retourné en tant qu’élément parent soit retourné en tant que parent lors des passes suivantes.

Voir aussi

S’applique à