CBCGPColorPickerCtrl

Detailed Description

The CBCGPColorPickerCtrl class implementation will help you to change the look & feel of the standard color-selection dialog. A CBCGPColorPickerCtrl object is a control with a list of colors in the hexagon form or luminance bar. The user can select a particular color from the list or luminance bar, which is then reported back to the application. The following is the picture of several CBCGPColorPickerCtrl objects:

The CBCGPColorPickerCtrl supports four styles:

• HEX and HEX_GREYSCALE - are suitable for the "standard" color selection.
• PICKER and LUMINANCE - are good for the custom color selection.

To incorporate the CBCGPColorPickerCtrl control into your dialog box template you have to perform the following steps:

• Insert a new button control (because CBCGPColorPickerCtrl class inherited from the CButton class) into your dialog box template.
• Insert a new member variable into your dialog box class associated with the new button. If you're using the ClassWizard, you will have to change the variable's type from CButton to CBCGPColorPickerCtrl.
• Insert the WM_INITDIALOG message handler for the dialog box class. This is the best place to define the actual type of the CBCGPColorPickerCtrl control, set its palette and initially displayed color.

If you want to take advantage of CBCGPColorPickerCtrl controls without addition programming efforts you may want to use CBCGPColorDialog.

See also

CBCGPColorDialog

Inherits CButton.

Public Types
enum	COLORTYPE
enum	CURSORTYPE

Public Member Functions
	CBCGPColorPickerCtrl	Constructs a CBCGPColorPickerCtrl object.
	AreLinesToCenter	Tells whether to draw the lines from the color's cursor to the picker center (PICKER_WHEEL exclusively).
	EnableLinesToCenter	Specifies whether to draw the lines from the color's cursor to the picker center (PICKER_WHEEL exclusively).
	GetBaseColorIndex	Retrieves an index of the "base" color.
	GetColor	Returns the selected color
	GetHLS	Retrieves the hue, luminance and saturation values of the selected color
	GetHorizontalAlignment	Retrieves a picker horizontal alignment.
	GetHue	Retrieves the hue component of the selected color
	GetHueDirection	Retrieved a color wheel hue direction.
	GetInternalPadding	Retrieves a color wheel internal padding
	GetLuminance	Retrieves the luminance component of the selected color
	GetRGB	Returns the selected color
	GetSaturation	Retrieves the saturation component of the selected color
	GetSelectedColorIndex	Retrieves the selected color index (PICKER_WHEEL only).
	GetStartAngle	Retrieved a color wheel start angle.
	GetVerticalAlignment	Retrieves a picker vertical alignment.
	IsSyncLuminosityWithSelectedColor	Tells whether the color wheel luminosity will be the same as the luminosity of the selected color (PICKER_WHEEL exclusively).
	SelectCellHexagon	Given the RGB values selects a new color
	SetColor	Forces the current selection to the specified RGB color
	SetColors	Specifies array of RGB values (PICKER_WHEEL only).
	SetColorsHLS	Specifies array of HLS values (PICKER_WHEEL only).
	SetHLS	Forces the current selection to the specified HLS values
	SetHorizontalAlignment	Specifies a picker horizontal alignment (PICKER_WHEEL type only).
	SetHue	Changes the hue component of the selected color
	SetInternalPadding	Specifies a color wheel internal padding
	SetLuminance	Changes the luminance component of the selected color
	SetLuminanceBarWidth	Sets a new luminance bar width
	SetOriginalColor	Sets the initial selected color. Call this function when a control is initialized.
	SetPalette	Sets the current color palette
	SetRGB	Selects a color in a color picker.
	SetSaturation	Changes the saturation component of the selected color
	SetSelectedColorIndex	Specifies the selected color index (PICKER_WHEEL only).
	SetStartAngle	Sets a color wheel start angle (PICKER_WHEEL type only).
	SetSyncLuminosityWithSelectedColor	Specifies whether the color wheel luminosity will be the same as the luminosity of the selected color (PICKER_WHEEL exclusively).
	SetType	Sets the color picker control type
	SetVerticalAlignment	Specifies a picker vertical alignment (PICKER_WHEEL type only).

Public Attributes
	m_bUseSystemPaletteByDefault	Specifies whether a control uses a default (system) palette.
	m_bVisualManagerStyle	Specifies whether a control has a Visual Manager style look.

Static Public Attributes
	m_bDefaultWheelHueDirection	This parameter sets the hue's default direction for all color wheel controls (PICKER_WHEEL type only).
	m_dblDefaultWheelStartAngle	This parameter specifies a default start angle that is used in all color wheel controls (in degrees, 0-360, PICKER_WHEEL type only).

Protected Member Functions
	DrawCursor	Called by the framework when a cursor that points to the selected color should be displayed