Image::GetThumbnailImage method (gdiplusheaders.h)

The Image::GetThumbnailImage method gets a thumbnail image from this Image object.


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


[in] thumbWidth

Type: UINT

Width, in pixels, of the requested thumbnail image.

[in] thumbHeight

Type: UINT

Height, in pixels, of the requested thumbnail image.

[in] callback

Type: GetThumbnailImageAbort

Optional. Callback function that you provide. During the process of creating or retrieving the thumbnail image, GDI+ calls this function to give you the opportunity to abort the process. The default value is NULL.


Type: VOID*

Optional. Pointer to a block of memory that contains data to be used by the callback function. The default value is NULL.

Return value

Type: Image*

This method returns a pointer to an Image object that contains the thumbnail image.


A thumbnail image is a small copy of an image. Some image files have a thumbnail image embedded in the file. In such cases, this method retrieves the embedded thumbnail image. If there is no embedded thumbnail image, this method creates a thumbnail image by scaling the main image to the size specified in the thumbWidth and thumbHeight parameters. If both of those parameters are 0, a system-defined size is used.


The following example creates an Image object based on a JPEG file. The code calls the Image::GetThumbnailImage method of that Image object and then displays the thumbnail image along with the main image.

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());

   delete pThumbnail;



Minimum supported client Windows XP, Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header gdiplusheaders.h (include Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

See also


Creating Thumbnail Images


Images, Bitmaps, and Metafiles