WM_CTLCOLORDLG message
Envoyé à une boîte de dialogue avant que le système ne dessine la boîte de dialogue. En répondant à ce message, la boîte de dialogue peut définir ses couleurs de texte et d’arrière-plan à l’aide du handle de contexte de périphérique d’affichage spécifié.
#define WM_CTLCOLORDLG 0x0136
Paramètres
-
wParam
-
Handle dans le contexte de l’appareil pour la boîte de dialogue.
-
lParam
-
Handle de la boîte de dialogue.
Valeur retournée
Si une application traite ce message, elle doit retourner un handle à un pinceau. Le système utilise le pinceau pour peindre l’arrière-plan de la boîte de dialogue.
Notes
Par défaut, la fonction DefWindowProc sélectionne les couleurs système par défaut pour la boîte de dialogue.
Le système ne détruit pas automatiquement le pinceau retourné. Il incombe à l’application de détruire la brosse quand elle n’est plus nécessaire.
Le message WM_CTLCOLORDLG n’est jamais envoyé entre les threads. Il n’est envoyé qu’au sein d’un seul thread.
Notez que le message WM_CTLCOLORDLG est envoyé à la boîte de dialogue elle-même ; tous les autres messages WM_CTLCOLOR* sont envoyés au propriétaire du contrôle.
Si une procédure de boîte de dialogue gère ce message, elle doit convertir la valeur de retour souhaitée en un INT_PTR et retourner la valeur directement. Si la procédure de boîte de dialogue retourne FALSE, la gestion des messages par défaut est effectuée. La valeur DWL_MSGRESULT définie par la fonction SetWindowLong est ignorée.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows 2000 Server [applications de bureau uniquement] |
| En-tête |
|
Voir aussi
-
Référence
-
Conceptuel
-
Autres ressources