Partager via


ChooseColor (function) (Windows CE 5.0)

Send Feedback

This function creates a Color common dialog box that enables the user to select a color.

BOOL ChooseColor(LPCHOOSECOLORlpcc);

Parameters

  • lpcc
    Long pointer to a CHOOSECOLOR (structure) that contains information used to initialize the dialog box. When ChooseColor returns, this structure contains information about the user's color selection.

Return Values

If the user clicks the OK button of the dialog box, the return value is nonzero. The rgbResult member of the CHOOSECOLOR structure contains the RGB color value of the color selected by the user.

If the user cancels or closes the Color dialog box or an error occurs, the return value is zero. To get extended error information, call the CommDlgExtendedError function, which can return one of the following values:

CDERR_FINDRESFAILURE CDERR_MEMALLOCFAILURE
CDERR_INITIALIZATION CDERR_NOHINSTANCE
CDERR_LOCKRESFAILURE CDERR_NOHOOK
CDERR_LOADRESFAILURE CDERR_NOTEMPLATE
CDERR_LOADSTRFAILURE CDERR_STRUCTSIZE

Remarks

The Color common dialog will ignore the CC_FULLOPEN flag if the target device screen is less than 480 pixels in width. In this case, the user must click the Define Custom Color button to display a second dialog with the custom color controls.

Note   In previous versions of Windows CE, the Color common dialog did not support user-defined colors if the target device screen is less than 480 pixels in width. In this case, the CC_FULLOPEN and CC_PREVENTFULLOPEN flags were ignored.

The Color dialog box does not support palettes. The color choices offered by the dialog box are limited to the system colors and dithered versions of those colors.

You can provide a CCHookProc hook procedure for a Color dialog box. The hook procedure can process messages sent to the dialog box. To enable a hook procedure, set the CC_ENABLEHOOK flag in the Flags member of the CHOOSECOLOR structure and specify the address of the hook procedure in the lpfnHook member.

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Commdlg.h.
Link Library: Commdlg.lib.

See Also

CCHookProc | CommDlgExtendedError | CHOOSECOLOR (structure)

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.