Compartilhar via


WM_CTLCOLORLISTBOX mensagem

Enviado para a janela pai de uma caixa de listagem antes que o sistema desmarque a caixa de listagem. Ao responder a essa mensagem, a janela pai pode definir o texto e as cores da tela de fundo da caixa de listagem usando o identificador de contexto do dispositivo de exibição especificado.

WM_CTLCOLORLISTBOX

    WPARAM wParam;
    LPARAM lParam; 

Parâmetros

wParam

Manipule para o contexto do dispositivo para a caixa de listagem.

lParam

Identificador para a caixa de listagem.

Valor retornado

Se um aplicativo processar essa mensagem, ele deverá retornar um identificador para um pincel. O sistema usa o pincel para pintar a tela de fundo da caixa de listagem.

Comentários

Por padrão, a função DefWindowProc seleciona as cores padrão do sistema para a caixa de listagem.

A mensagem WM_CTLCOLORLISTBOX nunca é enviada entre threads. Ele é enviado apenas dentro de um 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.

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 (inclua Windows.h)

Confira também

Outros recursos

Realizepalette

SelectPalette

DefWindowProc