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 |