IUIAutomation::ElementFromIAccessibleBuildCache 方法 (uiautomationclient.h)

从 Microsoft Active Accessibility 服务器检索指定辅助对象的 UI 自动化元素,预提取请求的属性和控件模式,并将预提取的项存储在缓存中。

语法

HRESULT ElementFromIAccessibleBuildCache(
  [in]          IAccessible               *accessible,
  [in]          int                       childId,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **element
);

参数

[in] accessible

类型: IAccessible*

指向可访问对象的 IAccessible 接口的指针。

[in] childId

类型: int

可访问对象的子 ID。

[in] cacheRequest

类型: IUIAutomationCacheRequest**

缓存请求的地址,该地址指定要存储在缓存中的属性和控件模式。

[out, retval] element

类型: IUIAutomationElement**

接收指向 UI 自动化元素的指针。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此方法使 Microsoft UI 自动化客户端能够获取由 Microsoft Active Accessibility 服务器实现的可访问对象的 IUIAutomationElement 接口。

如果服务器将 UI 自动化提供程序接口与 Microsoft Active Accessibility 支持一起实现,则此方法可能会失败。

如果 UI 自动化元素的基础实现不是本机 Microsoft Active Accessibility 服务器,则该方法返回E_INVALIDARG;也就是说,如果客户端尝试从 Oleacc.dll 或 UIA 到 MSAA 桥中检索最初受代理对象支持的元素的 IAccessible 接口。

要求

   
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新、带 SP3 的 Windows XP 和适用于 Windows Vista 的平台更新 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008、Windows Server 2003 SP2 和 Platform Update for Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 uiautomationclient.h (包括 UIAutomation.h)

另请参阅

IUIAutomation

IUIAutomation::ElementFromHandleBuildCache