Share via

TreeWalker.GetParent Метод

  • Ссылка

Определение

Пространство имен:
System.Windows.Automation
Сборка:
UIAutomationClient.dll

Извлекает родительский элемент заданного элемента AutomationElement.

Перегрузки

GetParent(AutomationElement)

Извлекает родительский элемент заданного элемента AutomationElement.
GetParent(AutomationElement, CacheRequest)

Извлекает родительский элемент заданного элемента AutomationElement и кэширует свойства и шаблоны.

Комментарии

Структура дерева изменяется по AutomationElement мере изменения видимых элементов пользовательского интерфейса на рабочем столе. При последующих проходах не гарантируется, что элемент, возвращенный в качестве родительского элемента, будет возвращен в качестве родительского элемента.

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

Элемент, для которого нужно возвратить родительский элемент.

Возвращаемое значение

AutomationElement

Родительский элемент или пустая ссылка (Nothing в Visual Basic), если указанный элемент является корневым элементом дерева или родительский элемент не отображается в текущем представлении.

Примеры

В следующем примере показано GetParent , как найти элемент window, содержащий указанный элемент.

/// <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 для кэширования.

Возвращаемое значение

AutomationElement

Родительский элемент или пустая ссылка (Nothing в Visual Basic), если указанный элемент является корневым элементом дерева или родительский элемент не отображается в этом представлении.

Комментарии

Структура дерева изменяется по AutomationElement мере изменения видимых элементов пользовательского интерфейса на рабочем столе. При последующих проходах не гарантируется, что элемент, возвращенный в качестве родительского элемента, будет возвращен в качестве родительского элемента.

См. также раздел

Применяется к