WM _ DWMSENDICONICTHUMBNAIL-Nachricht
Weist ein Fenster an, eine statische Bitmap bereitzustellen, die als Miniaturansichtsdarstellung dieses Fensters verwendet werden soll.
Parameter
-
wParam
-
Wird nicht verwendet.
-
lParam
-
HiWORD dieses Werts ist die maximale x-Koordinate der Miniaturansicht. LOWORD ist die maximale y-Koordinate. Wenn eine Miniaturansicht eine Dimension aufweist, die einen oder beide dieser Werte überschreitet, akzeptiert dwm die Miniaturansicht nicht.
Rückgabewert
Wenn eine Anwendung diese Nachricht verarbeitet, sollte sie 0 (null) zurückgeben.
Hinweise
DWM sendet diese Nachricht an ein Fenster, wenn alle der folgenden Situationen zutreffen:
- DWM zeigt eine repräsentative Darstellung des Fensters an.
- Das _ _ BITMAP-Attribut _ DWMWA HAS BITMAP ist im Fenster festgelegt.
- Im Fenster wurde keine zwischengespeicherte Bitmap festgelegt.
- Im Cache ist Platz für eine andere Bitmap.
Das Fenster, das diese Nachricht empfängt, sollte reagieren, indem eine Bitmap generiert wird, die nicht größer als die in den Nachrichtenparametern angeforderte Größe ist. Das Fenster ruft dann die DwmSetIconicThumbnail-Funktion auf, um die Standardminiaturansicht zu überschreiben. Wenn das Fenster in einem bestimmten Zeitraum keine Bitmap liefert, verwendet DWM eine eigene Standarddarstellung für das Fenster.
Das Fenster muss zum aufrufenden Prozess gehören.
Beispiele
Das folgende Codebeispiel zeigt, wie sie auf die WM-Nachricht _ DWMSENDICONICTHUMBNAIL reagieren. Im Beispiel wird DwmSetIconicThumbnailmit einem Handle für eine benutzerdefinierte, geräteunabhängige Bitmap zur Verwendung als Darstellung des Fensters verwendet.
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 im Beispiel Customize an Thumbnail Thumbnail and a Live Preview Bitmap (Anpassen einer miniaturisierten Miniaturansicht und einer Livevorschaubitmap).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
nur Windows 7 [ Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server 2008 [ R2-Desktop-Apps] |
| Header |
|