WM_CTLCOLORDLG mensaje

Se envía a un cuadro de diálogo antes de que el sistema dibuje el cuadro de diálogo. Al responder a este mensaje, el cuadro de diálogo puede establecer sus colores de texto y de fondo mediante el identificador de contexto del dispositivo de visualización especificado.

#define WM_CTLCOLORDLG                  0x0136

Parámetros

wParam

Identificador del contexto del dispositivo para el cuadro de diálogo.

lParam

Identificador del cuadro de diálogo.

Valor devuelto

Si una aplicación procesa este mensaje, debe devolver un identificador a un pincel. El sistema usa el pincel para pintar el fondo del cuadro de diálogo.

Comentarios

De forma predeterminada, la función DefWindowProc selecciona los colores del sistema predeterminados para el cuadro de diálogo.

El sistema no destruye automáticamente el pincel devuelto. Es responsabilidad de la aplicación destruir el pincel cuando ya no es necesario.

El mensaje WM_CTLCOLORDLG nunca se envía entre subprocesos. Solo se envía dentro de un subproceso.

Tenga en cuenta que el mensaje WM_CTLCOLORDLG se envía al propio cuadro de diálogo; todos los demás mensajes WM_CTLCOLOR* se envían al propietario del control.

Si un procedimiento de cuadro de diálogo controla este mensaje, debe convertir el valor devuelto deseado en un INT_PTR y devolver el valor directamente. Si el procedimiento del cuadro de diálogo devuelve FALSE, se realiza el control de mensajes predeterminado. Se omite el valor de DWL_MSGRESULT establecido por la función SetWindowLong .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Winuser.h (incluye Windows.h)

Consulte también

Referencia

DefWindowProc

SetWindowLong

Conceptual

Cuadros de diálogo

Otros recursos

RealizePalette

SelectPalette