Метод IUIAutomationElement::FindAllBuildCache (uiautomationclient.h)
Возвращает все элементы автоматизации пользовательского интерфейса, удовлетворяющие указанному условию, предварительно извлекает запрошенные свойства и шаблоны элементов управления и сохраняет предварительно подготовленные элементы в кэше.
Синтаксис
HRESULT FindAllBuildCache(
TreeScope scope,
[in] IUIAutomationCondition *condition,
[in] IUIAutomationCacheRequest *cacheRequest,
[out, retval] IUIAutomationElementArray **found
);
Параметры
scope
[in] condition
Тип: IUIAutomationCondition*
Указатель на условие, представляющее критерии для соответствия.
[in] cacheRequest
Тип: IUIAutomationCacheRequest*
Указатель на запрос кэша, указывающий шаблоны элементов управления и свойства, которые необходимо включить в кэш.
[out, retval] found
Тип: IUIAutomationElementArray**
Получает указатель на массив соответствующих элементов. Если совпадений нет, возвращается значение NULL .
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Область поиска относится к элементу, для которого вызывается метод . Элементы возвращаются в том порядке, в котором они были обнаружены в дереве.
Эта функция не может искать элементы-предки в дереве автоматизации пользовательского интерфейса Майкрософт; то есть TreeScope_Ancestors не является допустимым значением параметра область.
При поиске окон верхнего уровня на рабочем столе обязательно укажите 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) |
См. также раздел
Кэширование свойств автоматизации пользовательского интерфейса и шаблонов элементов управления
Основные понятия
Получение элементов автоматизации пользовательского интерфейса
Справочные материалы
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по