WM_CTLCOLORDLG

A mensagem WM_CTLCOLORDLG é enviada para uma caixa de diálogo antes que o sistema desenha a caixa de diálogo. Por responder a esta mensagem, a caixa de diálogo pode definir suas cores de texto e plano de fundo usando o identificador de contexto de dispositivo de Exibir determinado.

WM_CTLCOLORDLG hdcDlg = wParam (HDC);   / / identificador da caixa de diálogo caixa Exibir contexto hwndDlg = lParam (HWND); / / identificador da caixa de diálogo 

 

Parâmetros

hdcDlg
Valor de wParam. Identifica o contexto dispositivo para a caixa de diálogo.
hwndDlg
Valor de lParam. Identifica a caixa de diálogo.

Retornar valores

Se um aplicativo processa esta mensagem, ela deve retornar o identificador de um pincel. O sistema usa o pincel para tinta a segundo plano de caixa de diálogo.

Ação padrão

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

Observações

O sistema não automaticamente destruir o Pincel retornado. É responsabilidade do aplicativo para destruir o pincel quando ele não é mais necessário.

A mensagem WM_CTLCOLORDLG nunca é enviada entre segmentos. Ele é enviado apenas dentro de um segmento.

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

Se um procedimento caixa de diálogo trata esta mensagem, ela deve cast o valor de retorno desejado para um BOOL e retornar o valor diretamente. Se o procedimento caixa diálogo retorna FALSE, a mensagem padrão manipulação é executada. O valor DWL_MSGRESULT definido pelo SetWindowLong função é ignorado.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.

Ver também

Visão geral de caixas de diálogo, mensagens de caixa de diálogo, DefWindowProc, RealizePalette, SelectPalette, WM_CTLCOLORBTN, WM_CTLCOLOREDIT, WM_CTLCOLORLISTBOX, WM_CTLCOLORMSGBOX, WM_CTLCOLORSCROLLBAR, WM_CTLCOLORSTATIC

Index