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 IInitializeWithStream implementieren.

Vererbung

Die IThumbnailProvider-Schnittstelle erbt von der IUnknown-Schnittstelle . IThumbnailProvider verfügt auch über folgende Membertypen:

Methoden

Die IThumbnailProvider-Schnittstelle verfügt über diese Methoden.

 
IThumbnailProvider::GetThumbnail

Ruft ein Miniaturbild und einen Alphatyp ab.

Hinweise

Die Shell ruft IThumbnailProvider::GetThumbnail auf, um ein Image zu erhalten, 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 angegebene Implementierung verwenden, müssen mithilfe der GUID {C7657C4A-9F68-40fa-A4DF-96BC08EB3551} einen konstanten CLSID-Bezeichner definieren.

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

Initialisieren Das Objekt, das diese Schnittstelle implementiert, muss auch IInitializeWithStream implementieren. Die Shell ruft IInitializeWithStream::Initialize mit dem Stream des Elements auf, und IInitializeWithStream ist die einzige Initialisierungsschnittstelle, die verwendet wird, wenn IThumbnailProvider-Instanzen out-of-proc (zu Isolationszwecken) 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 wird, wenn der Handler von einem Drittanbieter ohne Verwendung der IThumbnailCache-API angefordert wird. Dies ist jedoch 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 IThumbnailProivder ist neu für Vista und ersetzt IExtractImage. Vista unterstützt weiterhin IExtractImage, aber es fehlt die Möglichkeit, den Bildtyp (Alpha oder nicht) zurückzugeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile thumbcache.h