Freigeben über

IThumbnailProvider-Schnittstelle (thumbcache.h)

  • Artikel

Macht eine Methode zum Abrufen eines Miniaturbilds verfügbar und soll für Miniaturansichtshandler implementiert werden. Das Objekt, das diese Schnittstelle implementiert, muss auch IInitializeWithStreamimplementieren.

Erbschaft

Die IThumbnailProvider Schnittstelle erbt von der IUnknown Schnittstelle. IThumbnailProvider hat auch folgende Typen von Membern:

Methodik

Die IThumbnailProvider Schnittstelle hat diese Methoden.

 
IThumbnailProvider::GetThumbnail

Ruft ein Miniaturbild und alpha-Typ ab.

Bemerkungen

Die Shell ruft IThumbnailProvider::GetThumbnail auf, um ein Bild abzurufen, das als Darstellung des Elements verwendet werden soll.

Eine Implementierung dieser Schnittstelle für Fotominiaturansichten wird in Microsoft Windows als CLSID_PhotoThumbnailProvider bereitgestellt. Anwendungen, die die bereitgestellte Implementierung verwenden, müssen einen konstanten CLSID-Bezeichner mithilfe der GUID {C7657C4A-9F68-40fa-A4DF-96BC08EB3551} definieren.

// {C7657C4A-9F68-40fa-A4DF-96BC08EB3551}
const CLSID CLSID_PhotoThumbnailProvider = {0xC7657C4A, 0x9F68, 0x40fa, {0xA4, 0xDF, 0x96, 0xBC, 0x08, 0xEB, 0x35, 0x51}} ;

Initialisierung Das Objekt, das diese Schnittstelle implementiert, muss auch IInitializeWithStreamimplementieren. Die Shell ruft IInitializeWithStream::Initialize mit dem Datenstrom des Elements auf, und IInitializeWithStream ist die einzige Initialisierungsschnittstelle, die verwendet wird, wenn IThumbnailProvider-Instanzen out-of-proc (für Isolationszwecke) geladen werden. Dies ist der primäre Codepfad für Windows für alle IThumbnailCache-Codepfade.

Es ist möglich, dass eine Miniaturansichtsimplementierung mit IInitializeWithItem oder IInitializeWithFile initialisiert werden kann, wenn der Handler von einem Drittanbieter angefordert wird, ohne die IThumbnailCache-API zu verwenden, aber dies ist ungewöhnlich. Wenn Sie IInitializeWithItem-implementieren, ruft die Shell IInitializeWithItem::Initialize mit der IShellItem- Darstellung des Elements auf. Wenn Sie IInitializeWithFile-implementieren, ruft die Shell IInitializeWithFile::Initialize mit dem Pfad der Datei auf.

Wenn keine dieser Schnittstellen vorhanden ist, wird IThumbnailProvider- nicht aufgerufen.

Client-Apps Wenn Sie eine Client-App entwickeln, sollten Sie stattdessen IShellItemImageFactory verwenden.

Windows Vista IThumbnailProvider ist neu für Vista und ersetzt IExtractImage. Vista unterstützt weiterhin IExtractImage, verfügt jedoch nicht über die Möglichkeit, den Bildtyp (Alpha oder nicht) zurückzugeben.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2008 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- thumbcache.h