messaggio di WM_CTLCOLORDLG

Inviato a una finestra di dialogo prima che il sistema estraa la finestra di dialogo. Rispondendo a questo messaggio, la finestra di dialogo può impostare il testo e i colori di sfondo usando l'handle del contesto di dispositivo di visualizzazione specificato.

#define WM_CTLCOLORDLG                  0x0136

Parametri

wParam

Handle per il contesto del dispositivo per la finestra di dialogo.

lParam

Handle per la finestra di dialogo.

Valore restituito

Se un'applicazione elabora questo messaggio, deve restituire un handle a un pennello. Il sistema utilizza il pennello per disegnare lo sfondo della finestra di dialogo.

Commenti

Per impostazione predefinita, la funzione DefWindowProc seleziona i colori di sistema predefiniti per la finestra di dialogo.

Il sistema non elimina automaticamente il pennello restituito. È responsabilità dell'applicazione distruggere il pennello quando non è più necessario.

Il messaggio WM_CTLCOLORDLG non viene mai inviato tra thread. Viene inviato solo all'interno di un thread.

Si noti che il messaggio WM_CTLCOLORDLG viene inviato alla finestra di dialogo stessa; tutti gli altri messaggi WM_CTLCOLOR* vengono inviati al proprietario del controllo.

Se una routine della finestra di dialogo gestisce questo messaggio, deve eseguire il cast del valore restituito desiderato in un INT_PTR e restituire direttamente il valore. Se la procedura della finestra di dialogo restituisce FALSE, viene eseguita la gestione predefinita dei messaggi. Il valore DWL_MSGRESULT impostato dalla funzione SetWindowLong viene ignorato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Winuser.h (include Windows.h)

Vedi anche

Riferimento

DefWindowProc

Setwindowlong

Informazioni concettuali

Finestre di dialogo

Altre risorse

RealizePalette

SelezionaPalette