Поделиться через


Метод IUIAutomationTreeWalker::GetFirstChildElement (uiautomationclient.h)

Извлекает первый дочерний элемент указанного элемента модель автоматизации пользовательского интерфейса.

Синтаксис

HRESULT GetFirstChildElement(
  [in]          IUIAutomationElement *element,
  [out, retval] IUIAutomationElement **first
);

Параметры

[in] element

Тип: IUIAutomationElement*

Указатель на элемент, для которого извлекается первый дочерний элемент.

[out, retval] first

Тип: IUIAutomationElement**

Получает указатель на первый дочерний элемент.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Элемент может иметь дополнительные дочерние элементы, которые не соответствуют текущему условию представления и, следовательно, не возвращаются при переходе по дереву элементов.

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

Требования

Требование Значение
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и Обновление платформы для Windows Vista, Windows XP с пакетом обновления 3 (SP3) и Обновление платформы для Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и обновление платформы для Windows Server 2008, Windows Server 2003 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header uiautomationclient.h (включая UIAutomation.h)