Gambar::Metode GetThumbnailImage (gdiplusheaders.h)

  • Artikel

Metode Image::GetThumbnailImage mendapatkan gambar mini dari objek Gambar ini.

Sintaks

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

Parameter

[in] thumbWidth

Jenis: UINT

Lebar, dalam piksel, dari gambar mini yang diminta.

[in] thumbHeight

Jenis: UINT

Tinggi, dalam piksel, dari gambar mini yang diminta.

[in] callback

Jenis: GetThumbnailImageAbort

Pilihan. Fungsi panggilan balik yang Anda berikan. Selama proses pembuatan atau pengambilan gambar mini, GDI+ memanggil fungsi ini untuk memberi Anda kesempatan untuk membatalkan proses. Nilai defaultnya adalah NULL.

callbackData

Jenis: VOID*

Opsional. Penunjuk ke blok memori yang berisi data yang akan digunakan oleh fungsi panggilan balik. Nilai defaultnya adalah NULL.

Nilai kembali

Jenis: Gambar*

Metode ini mengembalikan penunjuk ke objek Gambar yang berisi gambar mini.

Keterangan

Gambar mini adalah salinan kecil gambar. Beberapa file gambar memiliki gambar mini yang disematkan dalam file. Dalam kasus seperti itu, metode ini mengambil gambar mini yang disematkan. Jika tidak ada gambar mini yang disematkan, metode ini membuat gambar mini dengan menskalakan gambar utama ke ukuran yang ditentukan dalam parameter thumbWidth dan thumbHeight . Jika kedua parameter tersebut adalah 0, ukuran yang ditentukan sistem akan digunakan.

Contoh

Contoh berikut membuat objek Gambar berdasarkan file JPEG. Kode memanggil metode Image::GetThumbnailImage dari objek Image tersebut lalu menampilkan gambar mini bersama dengan gambar utama.

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;

}

Persyaratan

   
Klien minimum yang didukung Windows XP, Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header gdiplusheaders.h (termasuk Gdiplus.h)
Pustaka Gdiplus.lib
DLL Gdiplus.dll

Lihat juga

Bitmap

Membuat Gambar Mini

Gambar

Gambar, Bitmap, dan Metafiles