IPreviewHandlerFrame::GetWindowContext 方法 (shobjidl_core.h)

获取预览主机的键盘快捷方式列表。

语法

HRESULT GetWindowContext(
  [out] PREVIEWHANDLERFRAMEINFO *pinfo
);

参数

[out] pinfo

类型: PREVIEWHANDLERFRAMEINFO*

指向接收快捷键表信息的 PREVIEWHANDLERFRAMEINFO 结构的指针。

返回值

类型: HRESULT

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

注解

快捷键表是主机应执行的键盘快捷方式和命令的列表。 作为优化,预览处理程序随后可以查看它收到的击键,检查它们与快捷键表,以查看主机是否对它们感兴趣,并在适当情况下将其转发,同时忽略结构中的命令。 从 IPreviewHandlerFrame::GetWindowContext 返回的加速器表仅包含击键,不包含有效的命令条目。 预览处理程序还可以跳过此优化,只需为每次击键调用 IPreviewHandlerFrame::TranslateAccelerator 。 销毁预览处理程序时,必须使用 DestroyAcceleratorTable 函数释放加速器表。

当预览处理程序已调用 SetSite 并且结果已缓存供预览处理程序稍后使用时,应调用此方法。 在低完整性模式下运行的预览处理程序无法调用此方法。 对于每次击键,这些预览处理程序必须始终调用 IPreviewHandlerFrame::TranslateAccelerator

要求

要求
最低受支持的客户端 Windows Vista、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
可再发行组件 Windows 搜索 4 或更高版本

另请参阅

IPreviewHandlerFrame

IPreviewHandlerFrame::TranslateAccelerator