Метод IUIAutomation::GetRootElementBuildCache (uiautomationclient.h)
Извлекает элемент модель автоматизации пользовательского интерфейса, представляющий рабочий стол, предварительно извлекает запрошенные свойства и шаблоны элементов управления и сохраняет предварительно полученные элементы в кэше.
Синтаксис
HRESULT GetRootElementBuildCache(
[in] IUIAutomationCacheRequest *cacheRequest,
[out, retval] IUIAutomationElement **root
);
Параметры
[in] cacheRequest
Тип: IUIAutomationCacheRequest*
Указатель на запрос кэша, который указывает свойства и шаблоны элементов управления для хранения в кэше.
[out, retval] root
Тип: IUIAutomationElement**
Получает указатель на элемент модель автоматизации пользовательского интерфейса.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Корневой элемент можно использовать в качестве отправной точки для поиска других элементов с помощью методов FindAll и FindFirst .
При поиске из корневого элемента обязательно укажите TreeScope_Children в область поиска, а не TreeScope_Descendants. Поиск по всему поддереву рабочего стола может выполнить итерацию по тысячам элементов и привести к переполнению стека.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | 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) |