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