Метод Image::GetThumbnailImage (gdiplusheaders.h)

Статья
08/24/2023

Метод Image::GetThumbnailImage получает эскиз из этого объекта Image .

Синтаксис

Image * GetThumbnailImage(
  [in] UINT                   thumbWidth,
  [in] UINT                   thumbHeight,
  [in] GetThumbnailImageAbort callback,
       VOID                   *callbackData
);

Параметры

[in] thumbWidth

Тип: UINT

Ширина запрошенного эскиза изображения (в пикселях).

[in] thumbHeight

Тип: UINT

Высота запрошенного эскиза изображения (в пикселях).

[in] callback

Тип: GetThumbnailImageAbort

Необязательный элемент. Функция обратного вызова, которую вы предоставляете. В процессе создания или извлечения эскиза GDI+ вызывает эту функцию, чтобы дать возможность прервать процесс. Значение по умолчанию — NULL.

callbackData

Тип: VOID*

Необязательный элемент. Указатель на блок памяти, содержащий данные, используемые функцией обратного вызова. Значение по умолчанию — NULL.

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

Тип: Изображение*

Этот метод возвращает указатель на объект Image , содержащий эскиз изображения.

Эскиз — это небольшая копия изображения. Некоторые файлы изображений имеют эскиз, внедренный в файл. В таких случаях этот метод извлекает внедренное изображение эскиза. Если внедренное эскизное изображение отсутствует, этот метод создает эскиз, масштабируя изображение main до размера, указанного в параметрах thumbWidth и thumbHeight. Если оба этих параметра имеют значение 0, используется системный размер.

Примеры

В следующем примере создается объект Image на основе JPEG-файла. Код вызывает метод Image::GetThumbnailImage этого объекта Image, а затем отображает эскиз вместе с изображением main.

VOID Example_GetThumbnail(HDC hdc)
{
   Graphics graphics(hdc);

   // Create an image and a thumbnail of the image.
   Image image(L"Crayons.jpg");
   Image* pThumbnail = image.GetThumbnailImage(40, 40, NULL, NULL);

   // Draw the original and the thumbnail images.
   graphics.DrawImage(&image, 10, 10, image.GetWidth(), image.GetHeight());
   graphics.DrawImage(
      pThumbnail, 
      150, 
      10, 
      pThumbnail->GetWidth(), 
      pThumbnail->GetHeight());

   delete pThumbnail;

}

Требования


Минимальная версия клиента	Windows XP, Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	gdiplusheaders.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll

См. также раздел

Bitmap

Создание эскизов изображений

Изображение

Изображения, точечные рисунки и метафайлы