WM _ DWMSENDICONICLIVEPREVIEWBITMAP-Meldung

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 0 (null) zurückgeben.

Hinweise

Eine Livevorschau (auch als Vorschauvorschau einsehen bezeichnet) eines Fensters wird angezeigt, wenn ein Benutzer den Mauszeiger über die Miniaturansicht des Fensters in der Taskleiste bewegt oder den Miniaturansichtsfokus im ALT+TAB-Fenster erhält. Diese Ansicht ist eine Vorschau des Fensters in voller Größe und kann eine Livemomentaufnahme oder eine repräsentative Darstellung sein.

Desktopfenster-Manager (DWM) sendet diese Nachricht an ein Fenster, wenn alle der folgenden Situationen zutreffen:

  • Die Livevorschau wurde im Fenster aufgerufen.
  • Das _ _ BITMAP-Attribut _ DWMWA HAS BITMAP ist im Fenster festgelegt.
  • Eine Symboldarstellung ist die einzige darstellung, die für dieses Fenster vorhanden ist.

Das Fenster, das diese Nachricht empfängt, sollte durch Generieren einer vollständigen Bitmap reagieren. Das Fenster ruft dann die DwmSetIconicLivePreviewBitmap-Funktion auf, um die Livevorschau festzulegen. Wenn im Fenster in einem bestimmten Zeitraum keine Bitmap festgelegt wird, verwendet DWM eine eigene Standarddarstellung für das Fenster.

Beispiele

Im folgenden Beispiel wird eine Antwort auf die WM _ DWMSENDICONICLIVEPREVIEWBITMAP-Meldung veranschaulicht. Das Beispiel ruft die DwmSetIconicLivePreviewBitmap-Funktion mit einem Handle für eine benutzerdefinierte, geräteunabhängige Bitmap auf, 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 Customize an Thumbnail Thumbnail and a Live Preview Bitmap (Anpassen einer miniaturisierten Miniaturansicht und einer Bitmap mit Livevorschau).

Anforderungen

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

Siehe auch

WM _ DWMSENDICONICTHUMBNAIL

DwmInvalidateIconicBitmaps