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