Image：：GetThumbnailImage 方法 (gdiplusheaders.h)

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 物件的指標。

備註

縮圖影像是一小部分的影像複本。 有些影像檔案內嵌在檔案中的縮圖影像。 在這種情況下，此方法會擷取內嵌縮圖影像。 如果沒有內嵌縮圖影像，此方法會藉由將主要影像調整為 ThumbWidth 和 thumbHeight 參數中指定的大小來建立縮圖影像。 如果這兩個參數都是 0，則會使用系統定義的大小。

範例

下列範例會根據 JPEG 檔案建立 Image 物件。 程式碼會呼叫該 Image 物件的 Image：：GetThumbnailImage方法，然後顯示縮圖影像以及主要影像。

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;

}

需求

另請參閱

點陣圖

建立縮圖影像

映像

影像、點陣圖和中繼檔