WM_DWMSENDICONICTHUMBNAIL訊息

指示視窗提供靜態位圖，以做為該視窗的縮圖表示。

參數

wParam

未使用。

lParam

此值的 HIWORD 是縮圖的最大 x 座標。 LOWORD 是最大 Y 座標。 如果縮圖的維度超過其中一個或兩個值，DWM 不接受縮圖。

傳回值

如果應用程式處理此訊息，它應該會傳回零。

備註

如果下列所有情況都成立，DWM 會將此訊息傳送至視窗：

• DWM 會顯示視窗的圖示表示法。
• 視窗 上已設定DWMWA_HAS_ICONIC_BITMAP 屬性。
• 視窗未設定快取的點陣圖。
• 快取中有另一個點陣圖的空間。

接收此訊息的視窗應該透過產生不大於訊息參數中要求大小的點陣圖來回應。 然後視窗會呼叫 DwmSetIconicThumbnail 函式來覆寫預設縮圖。 如果視窗未在指定時間內提供點陣圖，DWM 會針對視窗使用自己的預設圖示表示法。

窗口必須屬於呼叫進程。

範例

下列程式代碼範例示範如何回應 WM_DWMSENDICONICTHUMBNAIL 訊息。 此範例會呼叫 DwmSetIconicThumbnail，其中包含自定義且與裝置無關的點陣圖句柄，以做為視窗的表示法。

        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;

如需完整的範例，請參閱 自定義圖示縮圖和即時預覽位圖 範例。

需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限傳統型應用程式]
頁首	Dwmapi.h

另請參閱

DwmInvalidateIconicBitmaps

WM_DWMSENDICONICLIVEPREVIEWBITMAP