IThumbnailProvider 接口 (thumbcache.h)
公开用于获取缩略图图像的方法,旨在实现缩略图处理程序。 实现此接口的对象还必须实现 IInitializeWithStream。
继承
IThumbnailProvider 接口继承自 IUnknown 接口。 IThumbnailProvider 也具有以下类型的成员:
方法
IThumbnailProvider 接口具有以下方法。
IThumbnailProvider::GetThumbnail 获取缩略图和 alpha 类型。 |
注解
Shell 调用 IThumbnailProvider::GetThumbnail 以获取要用作项表示形式的图像。
此照片缩略图接口的实现在 Microsoft Windows 中作为CLSID_PhotoThumbnailProvider提供。 使用提供的实现的应用程序必须使用 GUID {C7657C4A-9F68-40fa-A4DF-96BC08EB3551} 定义常量 CLSID 标识符。
// {C7657C4A-9F68-40fa-A4DF-96BC08EB3551}
const CLSID CLSID_PhotoThumbnailProvider = {0xC7657C4A, 0x9F68, 0x40fa, {0xA4, 0xDF, 0x96, 0xBC, 0x08, 0xEB, 0x35, 0x51}} ;
初始 化 实现此接口的对象还必须实现 IInitializeWithStream。 Shell 使用项的流调用 IInitializeWithStream::Initialize ,而 IInitializeWithStream 是将 IThumbnailProvider 实例加载到 (之外以便) 隔离时使用的唯一初始化接口。 这是所有 IThumbnailCache 代码路径的 Windows 的主要代码路径。
当处理程序由第三方请求而不使用 IThumbnailCache API 时,可以使用 IInitializeWithItem 或 IInitializeWithFile 初始化缩略图实现,但这并不常见。 如果实现 IInitializeWithItem,Shell 将使用项的 IShellItem 表示形式调用 IInitializeWithItem::Initialize。 如果实现 IInitializeWithFile,Shell 将使用文件的路径调用 IInitializeWithFile::Initialize 。
如果这些接口都不存在,则不调用 IThumbnailProvider 。
客户端应用 如果要开发客户端应用,应改用 IShellItemImageFactory 。
Windows Vista IThumbnailProivder 是 Vista 的新增功能,取代了 IExtractImage。 Vista 仍支持 IExtractImage,但无法返回图像类型 (alpha 或不) 。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | thumbcache.h |