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

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

  • Статья

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

Синтаксис

HRESULT GetEnclosingElementBuildCache(
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **enclosingElement
);

Параметры

[in] cacheRequest

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

[out, retval] enclosingElement

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

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

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

Комментарии

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

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

Требования

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

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

IUIAutomationTextRange3

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