Compartilhar via

Interface IThumbnailProvider (thumbcache.h)

  • Artigo

Expõe um método para obter uma imagem em miniatura e destina-se a ser implementado para manipuladores de miniaturas. O objeto que implementa essa interface também deve implementar IInitializeWithStream.

Herança

A interface IThumbnailProvider herda da interface IUnknown. IThumbnailProvider também tem estes tipos de membros:

Métodos

A interface IThumbnailProvider tem esses métodos.

 
IThumbnailProvider::GetThumbnail

Obtém uma imagem em miniatura e um tipo alfa.

Observações

O Shell chama IThumbnailProvider::GetThumbnail para obter uma imagem a ser usada como uma representação do item.

Uma implementação dessa interface para miniaturas de fotos é fornecida no Microsoft Windows como CLSID_PhotoThumbnailProvider. Os aplicativos que usam a implementação fornecida devem definir um identificador CLSID constante usando o 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}} ;

Inicializando O objeto que implementa essa interface também deve implementar IInitializeWithStream. O Shell chama IInitializeWithStream::Initialize com o fluxo do item e IInitializeWithStream é a única interface de inicialização usada quando instâncias IThumbnailProvider são carregadas fora do proc (para fins de isolamento). Este é o caminho de código primário para o Windows para todos os caminhos de código IThumbnailCache.

É possível que uma implementação em miniatura seja inicializada com IInitializeWithItem ou IInitializeWithFile quando o manipulador é solicitado por terceiros sem usar a API IThumbnailCache, mas isso é incomum. Se você implementar IInitializeWithItem, o Shell chamará IInitializeWithItem::Initialize com a representação IShellItem do item. Se você implementar IInitializeWithFile, o Shell chamará IInitializeWithFile::Initialize com o caminho do arquivo.

Se nenhuma dessas interfaces estiver presente, IThumbnailProvider não será chamado.

aplicativos cliente Se você estiver desenvolvendo um aplicativo cliente, deverá usar IShellItemImageFactory.

Windows Vista IThumbnailProvider é novo para Vista e substitui IExtractImage. O Vista ainda dá suporte a IExtractImage, mas não tem a capacidade de retornar o tipo de imagem (alfa ou não).

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho thumbcache.h