WM_DWMSENDICONICTHUMBNAIL 메시지

창에 해당 창의 썸네일 표현으로 사용할 정적 비트맵을 제공하도록 지시합니다.

매개 변수

wParam

사용되지 않습니다.

lParam

이 값의 HIWORD는 썸네일의 최대 x 좌표입니다. LOWORD는 최대 y 좌표입니다. 썸네일의 차원이 이러한 값 중 하나 또는 둘 다를 초과하는 경우 DWM은 썸네일을 허용하지 않습니다.

반환 값

애플리케이션이 이 메시지를 처리하면 0을 반환해야 합니다.

설명

다음 상황이 모두 참인 경우 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