сообщение WM_DWMSENDICONICTHUМБ NAIL

Указывает окну предоставить статическое растровое изображение, которое будет использоваться в качестве эскиза этого окна.

Параметры

wParam

Не используется.

lParam

HIWORD этого значения является максимальной координатой x эскиза. LoWORD — это максимальная координата y. Если эскиз имеет измерение, превышающее одно или оба из этих значений, DWM не принимает эскиз.

Возвращаемое значение

Если приложение обрабатывает это сообщение, оно должно возвращать ноль.

Замечания

DWM отправляет это сообщение в окно, если все следующие ситуации верны:

• DWM отображает знаковое представление окна.
• Атрибут DWMWA_HAS_ICONIC_BITMAP задан в окне.
• Окно не задало кэшированное растровое изображение.
• В кэше есть место для другого растрового изображения.

Окно, которое получает это сообщение, должно отвечать путем создания растрового изображения, который не превышает размер, запрошенный в параметрах сообщения. Затем окно вызывает функцию DwmSetIconicThumbnail , чтобы переопределить эскиз по умолчанию. Если окно не предоставляет растровое изображение в течение определенного периода времени, DWM использует собственное представление по умолчанию для окна.

Окно должно принадлежать вызывающей процедуре.

Примеры

В следующем примере кода показано, как реагировать на сообщение WM_DWMSENDICONICTHUМБ NAIL. В примере вызывается dwmSetIconicThumbnail с дескриптором настраиваемой, независимой от устройства растровой карты, используемой в качестве представления windows.

        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;

Полный пример см. в разделе " Настройка символьного эскиза" и примера растровой карты live Preview.

Requirements

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Верхний колонтитул	Dwmapi.h

См. также

DwmInvalidateIconicBitmaps

WM_DWMSENDICONICLIVEPREVIEWBITMAP