WM_CTLCOLORDLG mensagem

Enviado para uma caixa de diálogo antes que o sistema desmarque a caixa de diálogo. Ao responder a essa mensagem, a caixa de diálogo pode definir suas cores de texto e tela de fundo usando o identificador de contexto do dispositivo de exibição especificado.

#define WM_CTLCOLORDLG                  0x0136

Parâmetros

wParam

Um identificador para o contexto do dispositivo para a caixa de diálogo.

lParam

Um identificador para a caixa de diálogo.

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 diálogo.

Comentários

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

O sistema não destrói automaticamente o pincel retornado. É responsabilidade do aplicativo destruir o pincel quando ele não for mais necessário.

A mensagem WM_CTLCOLORDLG nunca é enviada entre threads. Ele é enviado somente em um thread.

Observe que a mensagem WM_CTLCOLORDLG é enviada para a própria caixa de diálogo; todas as outras mensagens WM_CTLCOLOR* são enviadas ao proprietário do controle.

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 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Winuser.h (inclua Windows.h)

Confira também

Referência

DefWindowProc

Setwindowlong

Conceitual

Caixas de diálogo

Outros recursos

Realizepalette

SelectPalette