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) |