Interface IThumbnailProvider (thumbcache.h)

Expose une méthode permettant d’obtenir une image miniature et est destinée à être implémentée pour les gestionnaires de miniatures. L’objet qui implémente cette interface doit également implémenter IInitializeWithStream.

Héritage

L’interface IThumbnailProvider hérite de l’interface IUnknown. IThumbnailProvider possède également ces types de membres :

Méthode

L’interface IThumbnailProvider a ces méthodes.

IThumbnailProvider ::GetThumbnail Obtient une image miniature et un type alpha.

Remarques

L’interpréteur de commandes appelle IThumbnailProvider ::GetThumbnail pour obtenir une image à utiliser comme représentation de l’élément.

Une implémentation de cette interface pour les miniatures de photos est fournie dans Microsoft Windows en tant que CLSID_PhotoThumbnailProvider. Les applications qui utilisent l’implémentation fournie doivent définir un identificateur CLSID constant à l’aide du 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}} ;

Initialisation L’objet qui implémente cette interface doit également implémenter IInitializeWithStream. L’interpréteur de commandes appelle IInitializeWithStream ::Initialize avec le flux de l’élément, et IInitializeWithStream est la seule interface d’initialisation utilisée lorsque les instances IThumbnailProvider sont chargées hors processus (à des fins d’isolation). Il s’agit du chemin de code principal de Windows pour tous les chemins de code IThumbnailCache.

Il est possible qu’une implémentation miniature soit initialisée avec IInitializeWithItem ou IInitializeWithFile lorsque le gestionnaire est demandé par une tierce partie sans utiliser l’API IThumbnailCache, mais cela est rare. Si vous implémentez IInitializeWithItem, l’interpréteur de commandes appelle IInitializeWithItem ::Initialize avec la représentation IShellItem de l’élément. Si vous implémentez IInitializeWithFile, l’interpréteur de commandes appelle IInitializeWithFile ::Initialize avec le chemin du fichier.

Si aucune de ces interfaces n’est présente, IThumbnailProvider n’est pas appelée.

applications clientes Si vous développez une application cliente, vous devez utiliser IShellItemImageFactory à la place.

Windows Vista IThumbnailProvider est nouveau pour Vista et remplace IExtractImage. Vista prend toujours en charge IExtractImage, mais ne peut pas retourner le type d’image (alpha ou non).

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	thumbcache.h