WM_DWMSENDICONICTHUMBNAIL-Meldung

Weist ein Fenster an, eine statische Bitmap bereitzustellen, die als Miniaturansicht dieses Fensters verwendet werden soll.

Parameter

wParam

Wird nicht verwendet.

lParam

Das HIWORD dieses Werts ist die maximale x-Koordinate der Miniaturansicht. Das LOWORD ist die maximale y-Koordinate. Wenn eine Miniaturansicht eine Dimension aufweist, die einen oder beide dieser Werte überschreitet, akzeptiert der DWM die Miniaturansicht nicht.

Rückgabewert

Wenn eine Anwendung diese Meldung verarbeitet, sollte sie 0 (null) zurückgeben.

Hinweise

DWM sendet diese Nachricht an ein Fenster, wenn alle folgenden Situationen zutreffen:

• DWM zeigt eine iconic-Darstellung des Fensters an.
• Das Attribut DWMWA_HAS_ICONIC_BITMAP wird im Fenster festgelegt.
• Das Fenster hat keine zwischengespeicherte Bitmap festgelegt.
• Es gibt Platz im Cache für eine andere Bitmap.

Das Fenster, das diese Meldung empfängt, sollte reagieren, indem eine Bitmap generiert wird, die nicht größer als die Größe ist, die in den Meldungsparametern angefordert wird. Anschließend ruft das Fenster die DwmSetIconicThumbnail-Funktion auf, um die Standardminiaturansicht außer Kraft zu setzen. Wenn das Fenster eine Bitmap in einem bestimmten Zeitraum nicht liefert, verwendet DWM eine eigene standardmäßige iconic-Darstellung für das Fenster.

Das Fenster muss zum aufrufenden Prozess gehören.

Beispiele

Das folgende Codebeispiel zeigt, wie auf die WM_DWMSENDICONICTHUMBNAIL-Meldung reagiert wird. Im Beispiel wird DwmSetIconicThumbnail mit einem Ziehpunkt für eine angepasste, geräteunabhängige Bitmap aufgerufen, die als Darstellung der Fenster verwendet werden soll.

        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;

Das vollständige Beispiel finden Sie unter Anpassen einer Iconic-Miniaturansicht und einer Livevorschau-Bitmap.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Header	Dwmapi.h

Siehe auch

DwmInvalidateIconicBitmaps

WM_DWMSENDICONICLIVEPREVIEWBITMAP