Метод IThumbnailProvider::GetThumbnail (thumbcache.h)

Статья
08/26/2023

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

Синтаксис

HRESULT GetThumbnail(
  [in]  UINT          cx,
  [out] HBITMAP       *phbmp,
  [out] WTS_ALPHATYPE *pdwAlpha
);

Параметры

[in] cx

Тип: UINT

Максимальный размер эскиза в пикселях. Оболочка рисует возвращаемое растровое изображение с таким размером или меньше. Возвращаемое растровое изображение должно помещаться в квадрат ширины и высоты cx, хотя это не обязательно должно быть квадратным изображением. Оболочка масштабирует растровое изображение для отрисовки с меньшими размерами. Например, если изображение имеет пропорции 6:4, то возвращаемое растровое изображение также должно иметь пропорции 6:4.

[out] phbmp

Тип: HBITMAP*

При возврате этим методом содержит указатель на дескриптор эскиза изображения. Изображение должно быть разделом DIB и 32 бита на пиксель. Оболочка масштабирует растровое изображение, если его ширина или высота больше размера, указанного в cx. Оболочка всегда учитывает пропорции и никогда не масштабирует растровое изображение больше, чем его исходный размер.

[out] pdwAlpha

Тип: WTS_ALPHATYPE*

При возврате этого метода содержит указатель на одно из следующих значений перечисления WTS_ALPHATYPE:

WTSAT_UNKNOWN (0x0)

0x0. Растровое изображение имеет неизвестный формат. Тем не менее оболочка пытается определить, имеет ли образ альфа-канал.

WTSAT_RGB (0x1)

0x1. Растровое изображение — это RGB-изображение без альфа-канала. Альфа-канал недопустим, и оболочка игнорирует его.

WTSAT_ARGB (0x2)

0x2. Растровое изображение представляет собой ARGB-изображение с допустимым альфа-каналом.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Требования


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

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