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