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

Статья
08/08/2024

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

Синтаксис

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

Параметры

[in] scope

Тип: TreeScope

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

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