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 |
|
Confira também
-
Referência
-
Outros recursos