Interface IThumbnailProvider (thumbcache.h)

  • Article

Expose une méthode pour 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 a également les types de membres suivants :

Méthodes

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 pour Windows pour tous les chemins de code IThumbnailCache.

Il est possible qu’une implémentation de miniature soit initialisée avec IInitializeWithItem ou IInitializeWithFile lorsque le gestionnaire est demandé par un tiers 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é.

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

Windows Vista IThumbnailProivder 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).

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête thumbcache.h