Interfaccia IThumbnailProvider (thumbcache.h)
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 |