Интерфейс IThumbnailProvider (thumbcache.h)

  • Статья

Предоставляет метод получения эскиза и предназначен для реализации для обработчиков эскизов. Объект, реализующий этот интерфейс, также должен реализовывать IInitializeWithStream.

Наследование

Интерфейс IThumbnailProvider наследуется от интерфейса IUnknown . IThumbnailProvider также имеет следующие типы элементов:

Методы

Интерфейс IThumbnailProvider содержит следующие методы.

 
IThumbnailProvider::GetThumbnail

Возвращает эскиз изображения и альфа-тип.

Комментарии

Оболочка вызывает IThumbnailProvider::GetThumbnail , чтобы получить изображение для использования в качестве представления элемента.

Реализация этого интерфейса для эскизов фотографий предоставляется в Microsoft Windows в виде CLSID_PhotoThumbnailProvider. Приложения, использующие предоставленную реализацию, должны определить постоянный идентификатор CLSID с помощью 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}} ;

Инициализации Объект, реализующий этот интерфейс, также должен реализовывать IInitializeWithStream. Оболочка вызывает IInitializeWithStream::Initialize с потоком элемента, а IInitializeWithStream является единственным интерфейсом инициализации, используемым при загрузке экземпляров IThumbnailProvider вне системы (в целях изоляции). Это основной путь к коду для Windows для всех путей кода IThumbnailCache.

Реализация эскизов может быть инициализирована с помощью IInitializeWithItem или IInitializeWithFile , если обработчик запрашивается сторонними лицами без использования API IThumbnailCache, но это редко. При реализации IInitializeWithItem оболочка вызывает IInitializeWithItem::Initialize с представлением элемента IShellItem . При реализации IInitializeWithFile оболочка вызывает IInitializeWithFile::Initialize с путем к файлу.

Если ни один из этих интерфейсов отсутствует, IThumbnailProvider не вызывается.

Клиентские приложения Если вы разрабатываете клиентское приложение, следует использовать вместо него IShellItemImageFactory .

Windows Vista IThumbnailProivder является новым для Vista и заменяет IExtractImage. Vista по-прежнему поддерживает IExtractImage, но не может возвращать тип изображения (альфа- или нет).

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header thumbcache.h