Compartilhar via


WM_CTLCOLORSCROLLBAR mensagem

A mensagem WM_CTLCOLORSCROLLBAR é enviada para a janela pai de um controle de barra de rolagem quando o controle está prestes a ser desenhado. Ao responder a essa mensagem, a janela pai pode usar o identificador de contexto de exibição para definir a cor da tela de fundo do controle de barra de rolagem.

Uma janela recebe essa mensagem por meio da função WindowProc.

WM_CTLCOLORSCROLLBAR

    WPARAM wParam
    LPARAM lParam; 

Parâmetros

wParam

Manipule para o contexto do dispositivo para o controle de barra de rolagem.

lParam

Manipule para a barra de rolagem.

Retornar valor

Se um aplicativo processar essa mensagem, ele deverá retornar o identificador para um pincel. O sistema usa o pincel para pintar a tela de fundo do controle de barra de rolagem.

Comentários

Se o aplicativo retornar um pincel que ele criou (por exemplo, usando a função CreateSolidBrush ou CreateBrushIndirect ), o aplicativo deverá liberar o pincel. Se o aplicativo retornar um pincel do sistema (por exemplo, aquele que foi recuperado pela função GetStockObject ou GetSysColorBrush ), o aplicativo não precisará liberar o pincel.

Por padrão, a função DefWindowProc seleciona as cores padrão do sistema para o controle de barra de rolagem.

A mensagem WM_CTLCOLORSCROLLBAR nunca é enviada entre threads; ele só é enviado dentro do mesmo thread.

Se um procedimento de caixa de diálogo manipular essa mensagem, ele deverá converter o valor retornado desejado em um INT_PTR e retornar o valor diretamente. Se o procedimento da caixa de diálogo retornar FALSE, o tratamento de mensagens padrão será executado. O valor DWL_MSGRESULT definido pela função SetWindowLong é ignorado.

A mensagem WM_CTLCOLORSCROLLBAR é usada apenas por controles de barra de rolagem filho. As barras de rolagem anexadas a uma janela (WS_SCROLL e WS_VSCROLL) não geram essa mensagem. Para personalizar a aparência das barras de rolagem anexadas a uma janela, use as funções de barra de rolagem simples.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclui Windows.h)

Confira também

Referência

WM_CTLCOLORBTN

WM_CTLCOLOREDIT

WM_CTLCOLORLISTBOX

WM_CTLCOLORSTATIC

Outros recursos

DefWindowProc

Realizepalette

SelectPalette

WM_CTLCOLORDLG