_Message WM CTLCOLORDLG

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 du contexte de périphérique pour la boîte de dialogue.

lParam

Handle de la boîte de dialogue.

Valeur de retour

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 de la boîte de dialogue.

Le système ne détruit pas automatiquement le pinceau retourné. Il incombe à l’application de détruire le pinceau lorsqu’il n’est plus nécessaire.

Le message WM _ CTLCOLORDLG n’est jamais envoyé entre les threads. Elle est envoyée uniquement au sein d’un 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 effectuer un cast de la valeur de retour souhaitée en _ ptr int et retourner la valeur directement. Si la procédure de boîte de dialogue retourne la valeur 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
Winuser. h (inclure Windows. h)

Voir aussi

Référence

DefWindowProc

SetWindowLong

Conceptuel

Boîtes de dialogue

Autres ressources

RealizePalette

SelectPalette