TreeWalker.GetParent メソッド

定義

指定した AutomationElement の親要素を取得します。

オーバーロード

GetParent(AutomationElement)

指定した AutomationElement の親要素を取得します。

GetParent(AutomationElement, CacheRequest)

指定した AutomationElement の親要素を取得し、プロパティとパターンをキャッシュします。

注釈

デスクトップ上で AutomationElement 表示されるユーザー インターフェイス (UI) 要素が変更されると、ツリーの構造が変わります。 親要素として返される要素が、後続のパスで親として返されることは保証されません。

GetParent(AutomationElement)

指定した AutomationElement の親要素を取得します。

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

パラメーター

element
AutomationElement

親が返される要素。

戻り値

親要素。指定した要素がツリーのルート要素である場合、または親要素が現在のビューに表示されない場合は、null 参照 (Visual Basic では Nothing)。

次の例は、指定した要素を含む window 要素を検索するために使用されていることを示しています GetParent

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

こちらもご覧ください

適用対象

GetParent(AutomationElement, CacheRequest)

指定した AutomationElement の親要素を取得し、プロパティとパターンをキャッシュします。

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

パラメーター

element
AutomationElement

親が返される要素。

request
CacheRequest

キャッシュ対象として返される AutomationElement のメンバーを指定するキャッシュ要求オブジェクト。

戻り値

親要素。指定した要素がツリーのルート要素である場合、または親要素がこのビューに表示されない場合は、null 参照 (Visual Basic では Nothing)。

注釈

デスクトップ上で AutomationElement 表示されるユーザー インターフェイス (UI) 要素が変更されると、ツリーの構造が変わります。 親要素として返される要素が、後続のパスで親として返されることは保証されません。

こちらもご覧ください

適用対象