COLOROKSTRING message

A Color dialog box sends the COLOROKSTRING registered message to your hook procedure, CCHookProc, when the user selects a color and clicks the OK button. The hook procedure can accept the color and allow the dialog box to close, or reject the color and force the dialog box to remain open.

#define COLOROKSTRING TEXT("commdlg_ColorOK")

Parameters

wParam

This parameter is not used.

lParam

A pointer to a CHOOSECOLOR structure. The rgbResult member of this structure contains the RGB color value of the selected color.

Return value

If the hook procedure returns zero, the Color dialog box accepts the selected color and closes.

If the hook procedure returns a nonzero value, the Color dialog box rejects the selected color and remains open.

Remarks

The hook procedure must specify the COLOROKSTRING constant in a call to the RegisterWindowMessage function to get the identifier of the message sent by the dialog box.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Commdlg.h (include Windows.h)
Unicode and ANSI names
COLOROKSTRINGW (Unicode) and COLOROKSTRINGA (ANSI)

See also

Reference

CHOOSECOLOR

RegisterWindowMessage

Conceptual

Common Dialog Box Library