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 时,可以使用 IInitializeWithItemIInitializeWithFile 初始化缩略图实现,但这并不常见。 如果实现 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