Поделиться через

Метод IUIAutomationTextRange3::GetChildrenBuildCache (uiautomationclient.h)

  • Статья

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

Синтаксис

HRESULT GetChildrenBuildCache(
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElementArray **children
);

Параметры

[in] cacheRequest

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

[out, retval] children

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

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

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

Комментарии

Следуя дизайну GetChildren:

  • Дочерние элементы, которые перекрываются с текстовым диапазоном, но не полностью заключены в него, также будут включены.
  • Если дочерних элементов нет, возвращается пустая коллекция.
В результате успешного вызова клиенты модель автоматизации пользовательского интерфейса могут вызывать кэшированные API IUIAutomationElement, которые предоставляются в cacheRequest, например IUIAutomationElement::GetCachedPropertyValue.

Требования

Требование Значение
Минимальная версия клиента Windows 10, версия 1703 [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header uiautomationclient.h (включая UIAutomation.h)

См. также раздел

IUIAutomationTextRange3

Модель автоматизации пользовательского интерфейса поддержка текстового содержимого