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 |
|
Vedi anche
-
Riferimento
-
Informazioni concettuali
-
Altre risorse