WM_DWMSENDICONICLIVEPREVIEWBITMAP Nachricht

Artikel
06/13/2023

Weist ein Fenster an, eine statische Bitmap bereitzustellen, die als Livevorschau (auch als Vorschauversion bezeichnet) dieses Fensters verwendet werden soll.

Parameter

wParam: Wird nicht verwendet.
lParam: Wird nicht verwendet.

Rückgabewert

Wenn eine Anwendung diese Nachricht verarbeitet, sollte sie null zurückgeben.

Bemerkungen

Eine Livevorschau (auch als Vorschau anzeigen bezeichnet) eines Fensters wird angezeigt, wenn ein Benutzer den Mauszeiger über die Miniaturansicht des Fensters in der Taskleiste bewegt oder die Miniaturansicht im ALT+TAB-Fenster fokusiert. Diese Ansicht ist eine Vorschau des Fensters in voller Größe und kann ein Live-Momentaufnahme oder eine ikonische Darstellung sein.

Desktop Window Manager (DWM) sendet diese Meldung an ein Fenster, wenn alle folgenden Situationen zutreffen:

Die Livevorschau wurde im Fenster aufgerufen.
Das attribut DWMWA_HAS_ICONIC_BITMAP wird im Fenster festgelegt.
Eine ikonische Darstellung ist die einzige, die für dieses Fenster vorhanden ist.

Das Fenster, das diese Nachricht empfängt, sollte reagieren, indem es eine bitmap im vollformatigen Umfang generiert. Das Fenster ruft dann die DwmSetIconicLivePreviewBitmap-Funktion auf, um die Livevorschau festzulegen. Wenn das Fenster in einem bestimmten Zeitraum keine Bitmap festgelegt, verwendet DWM eine eigene symbolträchtige Standarddarstellung für das Fenster.

Beispiele

Im folgenden Beispiel wird eine Antwort auf die WM_DWMSENDICONICLIVEPREVIEWBITMAP-Nachricht veranschaulicht. Im Beispiel wird die DwmSetIconicLivePreviewBitmap-Funktion mit einem Handle für eine benutzerdefinierte, geräteunabhängige Bitmap aufgerufen, die als Darstellung des Fensters verwendet werden soll.

        case WM_DWMSENDICONICLIVEPREVIEWBITMAP:
        {
            // This window is being asked to provide a bitmap to show in Peek preview.
            // This indicates the thumbnail in the taskbar is being previewed.
            RECT rectWindow = {0, 0, 0, 0};
            if (GetClientRect(hwnd, &rectWindow))
            {
                nWidth = rectWindow.right - rectWindow.left;
                nHeight = rectWindow.bottom - rectWindow.top;
            }

            hbm = CreateDIB(nWidth, nHeight);
            if (hbm)
            {
                hr = DwmSetIconicLivePreviewBitmap(hwnd, hbm, NULL, DWM_SIT_DISPLAYFRAME);
                DeleteObject(hbm);
            }
        }
        break;

Den vollständigen Code finden Sie im Beispiel Anpassen einer ikonischen 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

WM_DWMSENDICONICTHUMBNAIL
DwmInvalidateIconicBitmaps

Share via