Compartilhar via


WM_CTLCOLORDLG

Windows Mobile SupportedWindows Embedded CE Supported

9/9/2008

Esta mensagem é enviada para uma caixa diálogo antes Windows desenha o caixa de diálogo. Por responder a esta mensagem, a caixa diálogo pode definir seu texto e cores segundo plano usando o identificador contexto exibir determinado dispositivo. O DefWindowProc função seleciona as cores sistema usar como padrão para caixa de diálogo.

Syntax

WM_CTLCOLORDLG hdcDlg = (HDC) wParam; 
    hwndDlg = (HWND) lParam;

Parameters

  • hdcDlg
    Identificador de contexto de dispositivo para caixa de diálogo
  • hwndDlg
    Identificador de caixa de diálogo

Return Value

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 usar como padrão para caixa de diálogo.

Remarks

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

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

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

Se um procedimento caixa diálogo trata essa mensagem, ela deve CAST o valor de retorno desejado para um bool e retornar o valor diretamente. Se o procedimento caixa de diálogo retorna FALSE, em seguida, manipulação mensagem usar como padrão será executada. O valor DWL_MSGRESULT definido pelo SetWindowLong função será ignorada.

Requirements

Header winuser.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

DefWindowProc
SetWindowLong
Dialog Boxes Messages