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	Winuser.h (windows.h einschließen)

Siehe auch

Referenz

DefWindowProc

SetWindowLong

Konzept

Dialogfelder

Andere Ressourcen

RealizePalette

SelectPalette