Метод IUIAutomationElement::FindFirst (uiautomationclient.h)

Статья
08/08/2024

Извлекает первый дочерний или потомок элемент, соответствующий указанному условию.

Синтаксис

HRESULT FindFirst(
  [in]          TreeScope              scope,
  [in]          IUIAutomationCondition *condition,
  [out, retval] IUIAutomationElement   **found
);

Параметры

[in] scope

Тип: TreeScope

Сочетание значений, указывающих область поиска.

[in] condition

Тип: IUIAutomationCondition*

Указатель на условие, представляющее критерии для сопоставления.

[out, retval] found

Тип: IUIAutomationElement**

Получает указатель на элемент. значение NULL возвращается, если не найден соответствующий элемент.

Возвращаемое значение

Тип: HRESULT

Если этот метод выполнен успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT.

Замечания

Область поиска относится к элементу, на котором вызывается метод. Элементы возвращаются в порядке, в котором они были обнаружены в дереве.

Эта функция не может искать предки элементов в дереве автоматизации пользовательского интерфейса Майкрософт; То есть 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 [классические приложения только]
целевая платформа	Виндоус
заголовка	uiautomationclient.h (include UIAutomation.h)