Поделиться через

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

  • Статья

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

Наследство

Интерфейс IThumbnailProvid er наследует от интерфейса 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 не вызывается.

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows Vista [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2008 [только классические приложения]
целевая платформа Виндоус
заголовка thumbcache.h