WM _ CTLCOLORSCROLLBAR-Nachricht

Die WM _ CTLCOLORSCROLLBAR-Nachricht wird an das übergeordnete Fenster eines Bildlaufleisten-Steuerelements gesendet, wenn das Steuerelement gezeichnet werden soll. Durch Reagieren auf diese Meldung kann das übergeordnete Fenster das Anzeigekontexthandle verwenden, um die Hintergrundfarbe des Bildlaufleisten-Steuerelements festzulegen.

Ein Fenster empfängt diese Meldung über seine WindowProc-Funktion.

WM_CTLCOLORSCROLLBAR

    WPARAM wParam
    LPARAM lParam; 

Parameter

wParam

Verarbeiten Sie den Gerätekontext für das Bildlaufleisten-Steuerelement.

lParam

Handle für die Bildlaufleiste.

Rückgabewert

Wenn eine Anwendung diese Nachricht verarbeitet, muss sie das Handle an einen Pinsel zurückgeben. Das System verwendet den Pinsel, um den Hintergrund des Bildlaufleisten-Steuerelements zu zeichnen.

Bemerkungen

Wenn die Anwendung einen Pinsel zurückgibt, den sie erstellt hat (z. B. mithilfe der Funktion CreateSolidBrush oder CreateBrushIndirect), muss die Anwendung den Pinsel freigeben. Wenn die Anwendung einen Systempinsel zurückgibt (z. B. einen, der von der GetStockObject- oder GetSysColorBrush-Funktion abgerufen wurde), muss die Anwendung den Pinsel nicht freigeben.

Standardmäßig wählt die DefWindowProc-Funktion die Standardsystemfarben für das Scrollleisten-Steuerelement aus.

Die WM _ CTLCOLORSCROLLBAR-Nachricht wird nie zwischen Threads gesendet. Sie wird nur innerhalb desselben Threads gesendet.

Wenn eine Dialogfeldprozedur diese Nachricht verarbeitet, sollte sie den gewünschten Rückgabewert in einen INT _ PTR-Wert konvertieren und den Wert direkt zurückgeben. Wenn die Dialogfeldprozedur FALSE zurückgibt, wird die Standardmäßige Nachrichtenverarbeitung ausgeführt. Der _ von der SetWindowLong-Funktion festgelegte DWL-MSGRESULT-Wert wird ignoriert.

Die WM _ CTLCOLORSCROLLBAR-Nachricht wird nur von untergeordneten Bildlaufleisten-Steuerelementen verwendet. Scrollleisten, die an ein Fenster angefügt sind (WS _ SCROLL und WS _ VSCROLL), generieren diese Meldung nicht. Um die Darstellung von Bildlaufleisten anzupassen, die an ein Fenster angefügt sind, verwenden Sie die flachen Scrollleistenfunktionen.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [Nur Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Winuser.h (include Windows.h)

Weitere Informationen

Verweis

WM _ CTLCOLORBTN

WM _ CTLCOLOREDIT

WM _ CTLCOLORLISTBOX

WM _ CTLCOLORSTATIC

Andere Ressourcen

DefWindowProc

RealizePalette

Wählen SiePalette aus.

WM _ CTLCOLORDLG