pesan WM_DWMSENDICONICTHUMBNAIL

Artikel
01/06/2024

Menginstruksikan jendela untuk menyediakan bitmap statis untuk digunakan sebagai representasi gambar mini jendela tersebut.

Parameter

wParam: Tidak digunakan.
lParam: HIWORD dari nilai ini adalah koordinat x maksimum gambar mini. LOWORD adalah koordinat y maksimum. Jika gambar mini memiliki dimensi yang melebihi satu atau kedua nilai ini, DWM tidak menerima gambar mini.

Nilai hasil

Jika aplikasi memproses pesan ini, aplikasi harus mengembalikan nol.

Keterangan

DWM mengirim pesan ini ke jendela jika semua situasi berikut ini benar:

DWM menampilkan representasi ikonik jendela.
Atribut DWMWA_HAS_ICONIC_BITMAP diatur pada jendela.
Jendela tidak mengatur bitmap yang di-cache.
Ada ruang di cache untuk bitmap lain.

Jendela yang menerima pesan ini harus merespons dengan menghasilkan bitmap yang tidak lebih besar dari ukuran yang diminta dalam parameter pesan. Jendela kemudian memanggil fungsi DwmSetIconicThumbnail untuk mengambil alih gambar mini default. Jika jendela tidak menyediakan bitmap dalam jumlah waktu tertentu, DWM menggunakan representasi ikonik defaultnya sendiri untuk jendela.

Jendela harus termasuk dalam proses panggilan.

Contoh

Contoh kode berikut menunjukkan cara merespons pesan WM_DWMSENDICONICTHUMBNAIL . Contoh memanggil DwmSetIconicThumbnail, dengan handel ke bitmap yang disesuaikan dan independen perangkat untuk digunakan sebagai representasi jendela.

        case WM_DWMSENDICONICTHUMBNAIL:
        {    
            // This window is being asked to provide its iconic bitmap. This indicates
            // a thumbnail is being drawn.
            hbm = CreateDIB(HIWORD(lParam), LOWORD(lParam)); 
            if (hbm)
            {
                hr = DwmSetIconicThumbnail(hwnd, hbm, 0);
                DeleteObject(hbm);
            }
        }
        break;

Untuk contoh lengkapnya, lihat sampel Kustomisasi Gambar Mini Ikonik dan Bitmap Pratinjau Langsung.

Persyaratan

Persyaratan	Value
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Header	Dwmapi.h