TreeWalker.GetParent Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Извлекает родительский элемент заданного элемента 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
Элемент, для которого нужно возвратить родительский элемент.
Возвращаемое значение
Родительский элемент или пустая ссылка (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
См. также раздел
- Общие сведения о дереве модели автоматизации пользовательского интерфейса
- Навигация между элементами автоматизированного пользовательского интерфейса с помощью TreeWalker
- Получение элементов автоматизации пользовательского интерфейса
Применяется к
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 для кэширования.
Возвращаемое значение
Родительский элемент или пустая ссылка (Nothing
в Visual Basic), если указанный элемент является корневым элементом дерева или родительский элемент не отображается в этом представлении.
Комментарии
Структура дерева изменяется по AutomationElement мере изменения видимых элементов пользовательского интерфейса на рабочем столе. При последующих проходах не гарантируется, что элемент, возвращенный в качестве родительского элемента, будет возвращен в качестве родительского элемента.
См. также раздел
- Общие сведения о дереве модели автоматизации пользовательского интерфейса
- Навигация между элементами автоматизированного пользовательского интерфейса с помощью TreeWalker
- Получение элементов автоматизации пользовательского интерфейса