Share via


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) 要素が変更されると、ツリーの構造が変わります。 親要素として返される要素が、後続のパスで親として返されることは保証されません。

こちらもご覧ください

適用対象