IThumbnailProvider インターフェイス (thumbcache.h)

  • [アーティクル]

サムネイル画像を取得するためのメソッドを公開し、サムネイル ハンドラー用に実装することを目的としています。 このインターフェイスを実装する オブジェクトは 、IInitializeWithStream も実装する必要があります。

継承

IThumbnailProvider インターフェイスは、IUnknown インターフェイスから継承されます。 IThumbnailProvider には、次の種類のメンバーもあります。

メソッド

IThumbnailProvider インターフェイスには、これらのメソッドがあります。

 
IThumbnailProvider::GetThumbnail

サムネイル画像とアルファの種類を取得します。

注釈

シェルは 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 も実装する必要があります。 シェルは、項目のストリームを使用して IInitializeWithStream::Initialize を呼び出します。 IInitializeWithStream は、IThumbnailProvider インスタンスがアウトプロセスで読み込まれるときに使用される唯一の初期化インターフェイスです (分離のために)。 これは、すべての IThumbnailCache コード パスの Windows のプライマリ コード パスです。

IThumbnailCache API を使用せずにハンドラーがサード パーティから要求されている場合、サムネイル実装を IInitializeWithItem または IInitializeWithFile で初期化することは可能ですが、これは一般的ではありません。 IInitializeWithItem を実装する場合、シェルはアイテムの IShellItem 表現を使用して IInitializeWithItem::Initialize を呼び出します。 IInitializeWithFile を実装する場合、シェルはファイルのパスを使用して IInitializeWithFile::Initialize を呼び出します。

これらのインターフェイスが存在しない場合、 IThumbnailProvider は呼び出されません。

クライアント アプリ クライアント アプリを開発している場合は、代わりに IShellItemImageFactory を使用する必要があります。

Windows Vista IThumbnailProivder は Vista の新機能であり、 IExtractImage に置き換えられます。 Vista では引き続き IExtractImage がサポートされていますが、イメージの種類 (アルファかどうか) を返す機能がありません。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー thumbcache.h