CBCGPDialog

Detailed Description

The CBCGPDialog class extends the functionality of the CDialog class. It allows to define a background image or color for the dialog box window and handles all the palette transparency issues.

To take advantage of CBCGPDialog features you just need to derive your dialog class from the CBCGPDialog class instead of CDialog class.

When you call CBCGPDialog::SetBackgroundImage method and pass HBITMAP as the image handle, the CBCGPDialog object will take ownership over the image and delete it only if the m_bAutoDestroyBmp flag is TRUE. The current background image will be deleted if you call the SetBackgroundImage() again or by OnDestroy message handler. Images loaded from the resource file are always destroyed automatically.

See also

CBCGPPopupMenu, CBCGPContextMenuManager

Inheritance diagram for CBCGPDialog:

Public Types
enum	BackgroundLocation

Public Member Functions
	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.

Protected Attributes
	m_bDisableShadows	Specifies whether the dialog custom shadows should be disabled.