Метод IUIAutomation::ElementFromIAccessibleBuildCache (uiautomationclient.h)
Извлекает элемент автоматизации пользовательского интерфейса для указанного доступного объекта с сервера Microsoft Active Accessibility, предварительно получает запрошенные свойства и шаблоны элементов управления и сохраняет предварительно полученные элементы в кэше.
Синтаксис
HRESULT ElementFromIAccessibleBuildCache(
[in] IAccessible *accessible,
[in] int childId,
[in] IUIAutomationCacheRequest *cacheRequest,
[out, retval] IUIAutomationElement **element
);
Параметры
[in] accessible
Тип: IAccessible*
Указатель на интерфейс IAccessible доступного объекта.
[in] childId
Тип: int
Дочерний идентификатор доступного объекта.
[in] cacheRequest
Тип: IUIAutomationCacheRequest**
Адрес запроса кэша, указывающий свойства и шаблоны элементов управления для хранения в кэше.
[out, retval] element
Тип: IUIAutomationElement**
Получает указатель на элемент автоматизации пользовательского интерфейса.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Этот метод позволяет клиентам автоматизации пользовательского интерфейса Майкрософт получать интерфейсы IUIAutomationElement для доступных объектов, реализованных сервером Microsoft Active Accessibility.
Этот метод может завершиться ошибкой, если сервер реализует интерфейсы поставщика автоматизации пользовательского интерфейса вместе с поддержкой специальных возможностей Microsoft Active.
Метод возвращает E_INVALIDARG, если базовая реализация элемента автоматизации пользовательского интерфейса не является собственным сервером Microsoft Active Accessibility; то есть, если клиент пытается получить интерфейс IAccess для элемента, изначально поддерживаемого прокси-объектом, из Oleacc.dll или моста UIA-MSAA.
Требования
| Минимальная версия клиента | 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) |