Freigeben über


TreeWalker.GetParent Methode

Definition

Ruft das übergeordnete Element vom angegebenen AutomationElement ab.

Überlädt

GetParent(AutomationElement)

Ruft das übergeordnete Element vom angegebenen AutomationElement ab.

GetParent(AutomationElement, CacheRequest)

Ruft das übergeordnete Element vom angegebenen AutomationElement ab und speichert Eigenschaften und Muster zwischen.

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, als übergeordnetes Element bei nachfolgenden Übergeben zurückgegeben wird.

GetParent(AutomationElement)

Ruft das übergeordnete Element vom angegebenen AutomationElement ab.

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 NULL-Verweis (Nothing in Visual Basic), wenn das angegebene Element das Stammelement in der Struktur ist oder das übergeordnete Element in der aktuellen Ansicht nicht angezeigt wird.

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

Siehe auch

Gilt für

GetParent(AutomationElement, CacheRequest)

Ruft das übergeordnete Element vom angegebenen AutomationElement ab und speichert Eigenschaften und Muster zwischen.

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 Member im zurückgegebenen AutomationElement angibt, das zwischengespeichert werden soll.

Gibt zurück

AutomationElement

Das übergeordnete Element oder ein NULL-Verweis (Nothing in Visual Basic), wenn das angegebene Element das Stammelement in der Struktur ist oder das übergeordnete Element in dieser Ansicht nicht angezeigt wird.

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, als übergeordnetes Element bei nachfolgenden Übergeben zurückgegeben wird.

Siehe auch

Gilt für