CBCGPColorDialog

Detailed Description

The CBCGPColorDialog class encapsulates the color selection dialog box. The dialog is actually a property sheet with two pages. The first page allows to make a selection from one of the standard colors (from the system palette), the second page displays a control that allows to select a custom color. This dialog creates several CBCGPColorPickerCtrl objects and handles any palette issue (like system palette changes) transparently.

You can construct a CBCGPColorDialog object on the stack and then call DoModal. You can pass the initial color as a parameter to the CBCGPColorDialog constructor.

See also

CBCGPColorPickerCtrl

Inheritance diagram for CBCGPColorDialog:

Public Member Functions
	CBCGPColorDialog	Constructs a CBCGPColorDialog object
	GetColor	Returns the current selected color
	GetPalette	Returns the color's palette
	GetPickerType	Retrieves the color picker type
	SetCurrentColor	Sets the current selected color
	SetNewColor	Given an RGB value looks for a nearest color in the current palette and makes it the current selected color
	SetPageOne	Selects an RGB value for the first property page
	SetPageTwo	Selects an RGB value for the second property page
Public Member Functions inherited from CBCGPDialog
	CBCGPDialog	Constructs a CBCGPDialog object
	CBCGPDialog	Constructs a CBCGPDialog object
	AddCustomCaptionButton	Adds a custom caption button.
	AutoResizeControls	Enable auto-resizing check boxes, radio buttons and static labels.
	ClosePopupDlg	Closes the popup dialog.
	DoDrawSpecialAreaOnNC	Initiates drawing of specific area on the dialog box edges (non-client area). If you're calling this method, you should handle BCGM_ONDRAWNCSPECIALAREA registered message in your dialog class.
	EnableAero	Adds DWM ("Glass") support either to whole dialog, or to some of its margins.
	EnableCustomCaptionButton	Enables or disables a custom caption button.
	EnableDragClientArea	Allows to drag the dialog box by clicking inside the client area.
	EnableExpand	Enables expanding and collapsing of the dialog's part.
	EnableExpand	Enables expanding and collapsing of the dialog's part.
	EnableLayout	Enables or disables layout manager for a dialog box
	EnableLoadWindowPlacement	Enables loading/saving window placement from/to the registry.
	EnableVisualManagerStyle	Adds visual theme support to the dialog
	Expand	Expands or collapses the dialog box.
	GetAeroMargins	Retrieves the dialog DWM (glass) margins.
	GetInfoTipControl	Gets a dialog control with currently active info tip.
	GetLayout	Returns a pointer to layout manager.
	HasAeroMargins	Tells whether a window has "DWM (glass) margins.
	HasBackgroundImage	Tells whether the dialog has background image.
	IsAutoPrepareComboListStyles	Tells whether all child list box and combo boxes should be recreated by adding "owner-draw fixed" and "has strings" Windows styles.
	IsControlsDefaultDlgBackground	Tells whether controls background redrawing is optimized.
	IsCustomCaptionButtonEnabled	Tells whether a custom caption button is enabled.
	IsDragClientAreaEnabled	Tells whether a drag client area is enabled.
	IsExpandAreaSpecialBackground	Tells whether a dialog expanded area has a special background.
	IsExpanded	Tells whether the dialog box is expanded.
	IsGroupBoxesDrawByParent	Tells whether group box control is rendered by parent window.
	IsLayoutEnabled	Tells whether layout management is enabled for a dialog box.
	IsMFCResourceLayout	Tells whether the dialog uses MFC resource (loaded from the dialog resource) layout.
	IsOwnerDrawCaption	Tells whether a dialog has an owner-draw caption.
	IsVisualManagerNCArea	Tells whether a non-client area of the window uses visual manager style.
	IsVisualManagerStyle	Tells whether a window uses visual manager style.
	IsWindowPlacementEnabled	Tells whether loading/saving window placement from/to the registry is enabled.
	IsWsCaptionStyle	Tells whether a window with themed non-client area is created with WS_CAPTION style.
	OnAfterExpand	Called by the framework after the dialog was expanded.
	OnBeforeExpand	Called by the framework before the dialog is expanded.
	RemoveAllCustomCaptionButtons	Removes all custom caption buttons.
	RemoveInfoTips	Removes all previously added information tips.
	SetBackgroundColor	Sets a new background color
	SetBackgroundImage	Sets the dialog box's background image
	SetBackgroundImage	Sets the dialog box's background image
	SetControlInfoTip	Adds an information tip to the dialog child control specified by control ID.
	SetControlInfoTip	Adds an information tip to the dialog child control specified by window.
	SetControlsDefaultDlgBackground	Enables/disables child controls background optimized redrawing.
	SetEditBoxesSimplifiedBrowseIcon	Specifies whether all edit boxes located on the window should have simplified icons.
	SetEditBoxesVerticalAlignment	Specifies vertical alignment for all edit boxes located on the window (single-line only).
	SetExpandAreaSpecialBackground	Specifies whether a dialog expanded area has a special (usually darker) background.
	SetGroupBoxesDrawByParent	Enables drawing group box controls by the parent window.

Static Public Attributes
	m_DefaultColorPickerType	Specifies a default type of the color picker; CBCGPColorPickerCtrl::PICKER by default.

Protected Member Functions
	OnNewColorChanged	Called by framework when user modifies a color.

Additional Inherited Members
Public Types inherited from CBCGPDialog
enum	BackgroundLocation
Protected Attributes inherited from CBCGPDialog
	m_bDisableShadows	Specifies whether the dialog custom shadows should be disabled.