Метод IUIAutomationElement::GetCachedChildren (uiautomationclient.h)

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

Синтаксис

HRESULT GetCachedChildren(
  [out, retval] IUIAutomationElementArray **children
);

Параметры

[out, retval] children

Тип: IUIAutomationElementArray**

Получает указатель на коллекцию кэшированных дочерних элементов.

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

Тип: HRESULT

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

Комментарии

Представление возвращаемой коллекции определяется свойством TreeFilter объекта IUIAutomationCacheRequest , который был активен при получении этого элемента.

Дочерние элементы кэшируются только в том случае, если область запроса кэша включены TreeScope_Subtree, TreeScope_Children или TreeScope_Descendants.

Если запрос кэша указал, что дочерние элементы должны быть кэшированы на этом уровне, но дочерних элементов нет, значение этого свойства равно 0. Однако если запрос на кэширование дочерних элементов на этом уровне не был сделан, попытка получить свойство возвращает ошибку.

Требования

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

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

Основные понятия

GetCachedParent

IUIAutomationElement

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

Справочные материалы

Общие сведения о дереве модели автоматизации пользовательского интерфейса