Interfaccia IThumbnailProvider (thumbcache.h)

  • Articolo

Espone un metodo per ottenere un'immagine di anteprima ed è destinato a essere implementato per i gestori di anteprime. L'oggetto che implementa questa interfaccia deve implementare anche IInitializeWithStream.

Ereditarietà

L'interfaccia IThumbnailProvider eredita dall'interfaccia IUnknown . IThumbnailProvider include anche questi tipi di membri:

Metodi

L'interfaccia IThumbnailProvider include questi metodi.

 
IThumbnailProvider::GetThumbnail

Ottiene un'immagine di anteprima e un tipo alfa.

Commenti

Shell chiama IThumbnailProvider::GetThumbnail per ottenere un'immagine da usare come rappresentazione dell'elemento.

Un'implementazione di questa interfaccia per le anteprime foto viene fornita in Microsoft Windows come CLSID_PhotoThumbnailProvider. Le applicazioni che usano l'implementazione fornita devono definire un identificatore CLSID costante usando il GUID {C7657C4A-9F68-40fa-A4DF-96BC08EB3551}.

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

Inizializzazione L'oggetto che implementa questa interfaccia deve implementare anche IInitializeWithStream. Shell chiama IInitializeWithStream::Initialize con il flusso dell'elemento e IInitializeWithStream è l'unica interfaccia di inizializzazione usata quando vengono caricate istanze IThumbnailProvider (per scopi di isolamento). Si tratta del percorso del codice primario per Windows per tutti i percorsi di codice IThumbnailCache.

È possibile inizializzare un'implementazione di anteprima con IInitializeWithItem o IInitializeWithFile quando il gestore viene richiesto da una terza parte senza usare l'API IThumbnailCache, ma non è raro. Se si implementa IInitializeWithItem, shell chiama IInitializeWithItem::Initialize con la rappresentazione IShellItem dell'elemento. Se si implementa IInitializeWithFile, shell chiama IInitializeWithFile::Initialize con il percorso del file.

Se nessuna di queste interfacce è presente, IThumbnailProvider non viene chiamata.

App client Se si sta sviluppando un'app client, è consigliabile usare invece IShellItemImageFactory .

Windows Vista IThumbnailProivder è nuovo per Vista e sostituisce IExtractImage. Vista supporta ancora IExtractImage, ma non riesce a restituire il tipo di immagine (alfa o meno).

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione thumbcache.h