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