Share via


TreeWalker.GetParent Metoda

Definice

Načte nadřazený prvek zadaného AutomationElementobjektu .

Přetížení

GetParent(AutomationElement)

Načte nadřazený prvek zadaného AutomationElementobjektu .

GetParent(AutomationElement, CacheRequest)

Načte nadřazený prvek zadaných AutomationElement a ukládá do mezipaměti vlastnosti a vzory.

Poznámky

Struktura stromu se AutomationElement mění při změně viditelných prvků uživatelského rozhraní (UI) na ploše. Není zaručeno, že prvek vrácený jako nadřazený prvek bude vrácen jako nadřazený při následných průchodech.

GetParent(AutomationElement)

Načte nadřazený prvek zadaného AutomationElementobjektu .

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

Parametry

element
AutomationElement

Prvek, jehož nadřazený objekt má být vrácen.

Návraty

Nadřazený element nebo odkaz s hodnotou null (Nothing v jazyce Visual Basic), pokud je zadaný element kořenovým prvkem ve stromu nebo pokud nadřazený prvek není viditelný v aktuálním zobrazení.

Příklady

Následující příklad ukazuje GetParent použití k vyhledání prvku okna, který obsahuje zadaný prvek.

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

Viz také

Platí pro

GetParent(AutomationElement, CacheRequest)

Načte nadřazený prvek zadaných AutomationElement a ukládá do mezipaměti vlastnosti a vzory.

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

Parametry

element
AutomationElement

Prvek, jehož nadřazený objekt má být vrácen.

request
CacheRequest

Objekt požadavku na mezipaměť určující členy vrácených AutomationElement do mezipaměti.

Návraty

Nadřazený element nebo odkaz s hodnotou null (Nothing v jazyce Visual Basic), pokud je zadaný element kořenovým elementem ve stromu nebo nadřazený prvek není v tomto zobrazení viditelný.

Poznámky

Struktura stromu se AutomationElement mění při změně viditelných prvků uživatelského rozhraní (UI) na ploše. Není zaručeno, že prvek vrácený jako nadřazený prvek bude vrácen jako nadřazený při následných průchodech.

Viz také

Platí pro