Compartir a través de

Interfaz IThumbnailProvider (thumbcache.h)

  • Artículo

Expone un método para obtener una imagen en miniatura y está pensado para implementarse para los controladores de miniaturas. El objeto que implementa esta interfaz también debe implementar IInitializeWithStream.

Herencia

La interfaz IThumbnailProvider hereda de la interfaz IUnknown . IThumbnailProvider también tiene estos tipos de miembros:

Métodos

La interfaz IThumbnailProvider tiene estos métodos.

 
IThumbnailProvider::GetThumbnail

Obtiene una imagen en miniatura y un tipo alfa.

Comentarios

Shell llama a IThumbnailProvider::GetThumbnail para obtener una imagen que se usará como representación del elemento.

Se proporciona una implementación de esta interfaz para miniaturas de fotos en Microsoft Windows como CLSID_PhotoThumbnailProvider. Las aplicaciones que usan la implementación proporcionada deben definir un identificador CLSID constante mediante el 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}} ;

Inicializar El objeto que implementa esta interfaz también debe implementar IInitializeWithStream. Shell llama a IInitializeWithStream::Initialize con la secuencia del elemento y IInitializeWithStream es la única interfaz de inicialización que se usa cuando las instancias de IThumbnailProvider se cargan fuera de proceso (con fines de aislamiento). Esta es la ruta de acceso de código principal para Windows para todas las rutas de código IThumbnailCache.

Es posible que una implementación en miniatura se inicialice con IInitializeWithItem o IInitializeWithFile cuando un tercero solicita el controlador sin usar la API IThumbnailCache, pero esto es poco común. Si implementa IInitializeWithItem, el Shell llama a IInitializeWithItem::Initialize con la representación IShellItem del elemento. Si implementa IInitializeWithFile, shell llama a IInitializeWithFile::Initialize con la ruta de acceso del archivo.

Si ninguna de estas interfaces está presente, no se llama a IThumbnailProvider .

Aplicaciones cliente Si está desarrollando una aplicación cliente, debe usar IShellItemImageFactory en su lugar.

Windows Vista IThumbnailProivder es nuevo para Vista y reemplaza IExtractImage. Vista todavía admite IExtractImage, pero carece de la capacidad de devolver el tipo de imagen (alfa o no).

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado thumbcache.h