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