WM_CTLCOLORDLG Nachricht
Wird an ein Dialogfeld gesendet, bevor das System das Dialogfeld zeichnet. Durch Reaktion auf diese Meldung kann das Dialogfeld seine Text- und Hintergrundfarben mithilfe des angegebenen Anzeigegerätekontexthandles festlegen.
#define WM_CTLCOLORDLG 0x0136
Parameter
-
wParam
-
Ein Handle für den Gerätekontext für das Dialogfeld.
-
lParam
-
Ein Handle des Dialogfelds.
Rückgabewert
Wenn eine Anwendung diese Nachricht verarbeitet, muss sie ein Handle an einen Pinsel zurückgeben. Das System verwendet den Pinsel, um den Hintergrund des Dialogfelds zu zeichnen.
Bemerkungen
Standardmäßig wählt die DefWindowProc-Funktion die Standardsystemfarben für das Dialogfeld aus.
Das System zerstört den zurückgegebenen Pinsel nicht automatisch. Es liegt in der Verantwortung der Anwendung, den Pinsel zu zerstören, wenn er nicht mehr benötigt wird.
Die WM_CTLCOLORDLG Nachricht wird nie zwischen Threads gesendet. Es wird nur innerhalb eines Threads gesendet.
Beachten Sie, dass die WM_CTLCOLORDLG Nachricht an das Dialogfeld selbst gesendet wird. alle anderen WM_CTLCOLOR* -Nachrichten werden an den Besitzer des Steuerelements gesendet.
Wenn eine Dialogfeldprozedur diese Meldung verarbeitet, sollte sie den gewünschten Rückgabewert in einen INT_PTR umwandeln und den Wert direkt zurückgeben. Wenn die Dialogfeldprozedur FALSE zurückgibt, wird die Standardmeldungsbehandlung ausgeführt. Der von der SetWindowLong-Funktion festgelegte DWL_MSGRESULT Wert wird ignoriert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
Siehe auch
-
Referenz
-
Konzept
-
Andere Ressourcen