Metode IThumbnailProvider::GetThumbnail (thumbcache.h)

Mendapatkan gambar mini dan jenis alfa.

Sintaks

HRESULT GetThumbnail(
  [in]  UINT          cx,
  [out] HBITMAP       *phbmp,
  [out] WTS_ALPHATYPE *pdwAlpha
);

Parameter

[in] cx

Jenis: UINT

Ukuran gambar mini maksimum, dalam piksel. Shell menggambar bitmap yang dikembalikan pada ukuran ini atau lebih kecil. Bitmap yang dikembalikan harus sesuai dengan persegi lebar dan tinggi cx, meskipun tidak perlu menjadi gambar persegi. Shell menskalakan bitmap untuk dirender pada ukuran yang lebih rendah. Misalnya, jika gambar memiliki rasio aspek 6:4, maka bitmap yang dikembalikan juga harus memiliki rasio aspek 6:4.

[out] phbmp

Jenis: HBITMAP*

Ketika metode ini kembali, berisi penunjuk ke handel gambar mini. Gambar harus merupakan bagian DIB dan 32 bit per piksel. Shell menurunkan skala bitmap jika lebar atau tingginya lebih besar dari ukuran yang ditentukan oleh cx. Shell selalu menghormati rasio aspek dan tidak pernah menskalakan bitmap yang lebih besar dari ukuran aslinya.

[out] pdwAlpha

Jenis: WTS_ALPHATYPE*

Saat metode ini kembali, berisi penunjuk ke salah satu nilai berikut dari enumerasi WTS_ALPHATYPE:

WTSAT_UNKNOWN (0x0)

0x0. Bitmap adalah format yang tidak diketahui. Shell mencoba untuk mendeteksi apakah gambar memiliki saluran alfa.

WTSAT_RGB (0x1)

0x1. Bitmap adalah gambar RGB tanpa alfa. Saluran alfa tidak valid dan Shell mengabaikannya.

WTSAT_ARGB (0x2)

0x2. Bitmap adalah gambar ARGB dengan saluran alfa yang valid.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Persyaratan

Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	thumbcache.h