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 的设计:

  • 获取文本范围中最内部的全能封闭元素和元素提供的属性。
成功调用后,UI 自动化客户端能够调用 cacheRequest 中提供的 IUIAutomationElement 的“Cached”API,例如 IUIAutomationElement::GetCachedPropertyValue

要求

要求
最低受支持的客户端 Windows 10版本 1703 [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 uiautomationclient.h (包括 UIAutomation.h)

另请参阅

IUIAutomationTextRange3

对文本内容的UI 自动化支持