TreeWalker.GetParent Methode

Definition

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

Ruft das übergeordnete Element des angegebenen AutomationElementab.

Überlädt

Name Beschreibung
GetParent(AutomationElement)

Ruft das übergeordnete Element des angegebenen AutomationElementab.
GetParent(AutomationElement, CacheRequest)

Ruft das übergeordnete Element der angegebenen AutomationElement Und zwischenspeichert Eigenschaften und Muster.

Hinweise

Die Struktur der AutomationElement Struktur ändert sich, wenn sich die elemente der sichtbaren Benutzeroberfläche (UI) auf dem Desktop ändern. Es ist nicht garantiert, dass ein Element, das als übergeordnetes Element zurückgegeben wird, bei nachfolgenden Durchläufen als übergeordnetes Element zurückgegeben wird.

GetParent(AutomationElement)

Ruft das übergeordnete Element des angegebenen AutomationElementab.

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

Parameter

element
AutomationElement

Das Element, dessen übergeordnetes Element zurückgegeben werden soll.

Gibt zurück

AutomationElement

Das übergeordnete Element oder ein Nullverweis (Nothing in Visual Basic), wenn das angegebene Element das Stammelement in der Struktur ist oder das übergeordnete Element in der aktuellen Ansicht nicht sichtbar ist.

Beispiele

Das folgende Beispiel zeigt GetParent , wie das Fensterelement gefunden wird, das ein angegebenes Element enthält.

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

Weitere Informationen

Gilt für:

GetParent(AutomationElement, CacheRequest)

Ruft das übergeordnete Element der angegebenen AutomationElement Und zwischenspeichert Eigenschaften und Muster.

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

Parameter

element
AutomationElement

Das Element, dessen übergeordnetes Element zurückgegeben werden soll.

request
CacheRequest

Ein Cacheanforderungsobjekt, das Elemente für den zurückgegebenen AutomationElement Cache angibt.

Gibt zurück

AutomationElement

Das übergeordnete Element oder ein Nullverweis (Nothing in Visual Basic), wenn das angegebene Element das Stammelement in der Struktur ist oder das übergeordnete Element in dieser Ansicht nicht sichtbar ist.

Hinweise

Die Struktur der AutomationElement Struktur ändert sich, wenn sich die elemente der sichtbaren Benutzeroberfläche (UI) auf dem Desktop ändern. Es ist nicht garantiert, dass ein Element, das als übergeordnetes Element zurückgegeben wird, bei nachfolgenden Durchläufen als übergeordnetes Element zurückgegeben wird.

Weitere Informationen

Gilt für: