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