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	Winuser.h (inclure Windows.h)

Voir aussi

Référence

DefWindowProc

SetWindowLong

Conceptuel

Boîtes de dialogue

Autres ressources

RéaliserPalette

SélectionnerPalette