WM_DWMSENDICONICLIVEPREVIEWBITMAP pesan

  • Artikel

Menginstruksikan jendela untuk menyediakan bitmap statis untuk digunakan sebagai pratinjau langsung (juga dikenal sebagai pratinjau Intip) dari jendela tersebut.

Parameter

wParam

Tidak digunakan.

lParam

Tidak digunakan.

Menampilkan nilai

Jika aplikasi memproses pesan ini, aplikasi harus mengembalikan nol.

Keterangan

Pratinjau langsung (juga dikenal sebagai pratinjau Intip) jendela muncul saat pengguna memindahkan penunjuk mouse ke atas gambar mini jendela di taskbar atau memberikan fokus gambar mini di jendela ALT+TAB. Tampilan ini adalah pratinjau jendela berukuran penuh dan dapat menjadi rekam jepret langsung atau representasi ikonik.

Desktop Window Manager (DWM) mengirimkan pesan ini ke jendela jika semua situasi berikut ini benar:

  • Pratinjau langsung telah dipanggil pada jendela.
  • Atribut DWMWA_HAS_ICONIC_BITMAP diatur pada jendela.
  • Representasi ikonik adalah satu-satunya yang ada untuk jendela ini.

Jendela yang menerima pesan ini harus merespons dengan menghasilkan bitmap skala penuh. Jendela kemudian memanggil fungsi DwmSetIconicLivePreviewBitmap untuk mengatur pratinjau langsung. Jika jendela tidak mengatur bitmap dalam jumlah waktu tertentu, DWM menggunakan representasi ikonik defaultnya sendiri untuk jendela.

Contoh

Contoh berikut menunjukkan respons terhadap pesan WM_DWMSENDICONICLIVEPREVIEWBITMAP . Contoh memanggil fungsi DwmSetIconicLivePreviewBitmap dengan handel ke bitmap independen perangkat yang disesuaikan untuk digunakan sebagai representasi jendela.

        case WM_DWMSENDICONICLIVEPREVIEWBITMAP:
        {
            // This window is being asked to provide a bitmap to show in Peek preview.
            // This indicates the thumbnail in the taskbar is being previewed.
            RECT rectWindow = {0, 0, 0, 0};
            if (GetClientRect(hwnd, &rectWindow))
            {
                nWidth = rectWindow.right - rectWindow.left;
                nHeight = rectWindow.bottom - rectWindow.top;
            }

            hbm = CreateDIB(nWidth, nHeight);
            if (hbm)
            {
                hr = DwmSetIconicLivePreviewBitmap(hwnd, hbm, NULL, DWM_SIT_DISPLAYFRAME);
                DeleteObject(hbm);
            }
        }
        break;

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

Persyaratan

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

Lihat juga

WM_DWMSENDICONICTHUMBNAIL

DwmInvalidateIconicBitmaps