Condividi tramite

Interfaccia IThumbnailProvider (thumbcache.h)

  • Articolo

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

Eredità

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

Metodi

L'interfaccia IThumbnailProvider dispone di questi metodi.

 
IThumbnailProvider::GetThumbnail

Ottiene un'immagine di anteprima e un tipo alfa.

Osservazioni

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

Un'implementazione di questa interfaccia per le anteprime di 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). Questo è il percorso di 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 questo non è comune. 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, non viene chiamato IThumbnailProvider.

App client Se si sviluppa un'app client, è consigliabile usare IShellItemImageFactory.

Windows Vista IThumbnailProvider è una novità per Vista e sostituisce IExtractImage. Vista supporta ancora IExtractImage, ma non ha la possibilità di restituire il tipo di immagine (alfa o meno).

Fabbisogno

Requisito Valore
client minimo supportato Windows Vista [solo app desktop]
server minimo supportato Windows Server 2008 [solo app desktop]
piattaforma di destinazione Finestre
intestazione thumbcache.h