Image：：GetThumbnailImage 方法 (gdiplusheaders.h)

  • 项目

Image：：GetThumbnailImage 方法从此 Image 对象获取缩略图。

语法

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

parameters

[in] thumbWidth

类型： UINT

所请求缩略图的宽度（以像素为单位）。

[in] thumbHeight

类型： UINT

所请求缩略图的高度（以像素为单位）。

[in] callback

类型： GetThumbnailImageAbort

可选。 提供的回调函数。 在创建或检索缩略图的过程中，GDI+ 会调用此函数，使你有机会中止该进程。 默认值为 NULL。

callbackData

类型： VOID*

可选。 指向包含回调函数要使用的数据的内存块的指针。 默认值为 NULL。

返回值

类型： 图像*

此方法返回指向包含缩略图 的 Image 对象的指针。

注解

缩略图是图像的小型副本。 某些图像文件在文件中嵌入了缩略图。 在这种情况下，此方法检索嵌入的缩略图图像。 如果没有嵌入的缩略图，此方法通过将main图像缩放到 thumbWidth 和 thumbHeight 参数中指定的大小来创建缩略图。 如果这两个参数均为 0，则使用系统定义的大小。

示例

以下示例基于 JPEG 文件创建 Image 对象。 该代码调用该Image 对象的 Image：：GetThumbnailImage 方法，然后显示缩略图以及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
标头 gdiplusheaders.h (包括 Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

另请参阅

Bitmap

创建缩略图图像

图像

图像、位图和图元文件