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

Статья
03/03/2024

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

Синтаксис

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

Параметры

scope

[in] condition

Тип: IUIAutomationCondition*

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

[in] cacheRequest

Тип: IUIAutomationCacheRequest*

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

[out, retval] found

Тип: IUIAutomationElement**

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

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

Тип: HRESULT

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

Эта функция не может искать элементы-предки в дереве Microsoft модель автоматизации пользовательского интерфейса, то есть TreeScope_Ancestors не является допустимым значением для параметра область.

При поиске окон верхнего уровня на рабочем столе не забудьте указать TreeScope_Children в параметре область, а не TreeScope_Descendants. Поиск по всему поддереву рабочего стола может выполнить итерацию по тысячам элементов и привести к переполнению стека.

Если клиентское приложение может попытаться найти элементы в собственном пользовательском интерфейсе, необходимо выполнить все вызовы модель автоматизации пользовательского интерфейса в отдельном потоке.

Чтобы выполнить поиск в необработанном дереве, укажите соответствующий объект TreeScope в параметре cacheRequest .

Требования

Требование	Значение
Минимальная версия клиента	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)