TreeWalker.GetParent Methode

Definitie

Naamruimte:
System.Windows.Automation
Assembly:
UIAutomationClient.dll

Haalt het bovenliggende element van het opgegeven AutomationElementelement op.

Overloads

Name Description
GetParent(AutomationElement)

Haalt het bovenliggende element van het opgegeven AutomationElementelement op.
GetParent(AutomationElement, CacheRequest)

Hiermee haalt u het bovenliggende element van de opgegeven AutomationElement eigenschappen en patronen in de cache op.

Opmerkingen

De structuur van de AutomationElement structuur verandert als de zichtbare elementen van de gebruikersinterface (UI) op het bureaublad veranderen. Het is niet gegarandeerd dat een element dat wordt geretourneerd als het bovenliggende element, wordt geretourneerd als het bovenliggende element op volgende doorgegeven.

GetParent(AutomationElement)

Haalt het bovenliggende element van het opgegeven AutomationElementelement op.

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

Parameters

element
AutomationElement

Het element waarvan het bovenliggende element moet worden geretourneerd.

Retouren

AutomationElement

Het bovenliggende element of een null-verwijzing (Nothing in Visual Basic) als het opgegeven element het hoofdelement in de structuur is of als het bovenliggende element niet zichtbaar is in de huidige weergave.

Voorbeelden

In het volgende voorbeeld ziet GetParent u hoe u het vensterelement kunt vinden dat een opgegeven element bevat.

/// <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

Zie ook

Van toepassing op

GetParent(AutomationElement, CacheRequest)

Hiermee haalt u het bovenliggende element van de opgegeven AutomationElement eigenschappen en patronen in de cache op.

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

Parameters

element
AutomationElement

Het element waarvan het bovenliggende element moet worden geretourneerd.

request
CacheRequest

Een cacheaanvraagobject dat leden opgeeft op de geretourneerde AutomationElement cache.

Retouren

AutomationElement

Het bovenliggende element of een null-verwijzing (Nothing in Visual Basic) als het opgegeven element het hoofdelement in de structuur is of het bovenliggende element niet zichtbaar is in deze weergave.

Opmerkingen

De structuur van de AutomationElement structuur verandert als de zichtbare elementen van de gebruikersinterface (UI) op het bureaublad veranderen. Het is niet gegarandeerd dat een element dat wordt geretourneerd als het bovenliggende element, wordt geretourneerd als het bovenliggende element op volgende doorgegeven.

Zie ook

Van toepassing op