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

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

  • Статья

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

Синтаксис

HRESULT GetFirstChildElementBuildCache(
  [in]          IUIAutomationElement      *element,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **first
);

Параметры

[in] element

Тип: IUIAutomationElement*

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

[in] cacheRequest

Тип: IUIAutomationCacheRequest*

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

[out, retval] first

Тип: IUIAutomationElement**

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

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

Тип: HRESULT

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

Комментарии

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

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

Требования

   
Минимальная версия клиента 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)