CBCGPMessageBox

Detailed Description

The CBCGPMessageBox class implements a message box that is displayed using current visual theme.

In addition it can be configured to display a check box, user-defined buttons, a separator between "message" and "buttons" area, a banner in the "buttons" area.

All these options can be specified and passed in using BCGP_MSGBOXPARAMS structure.

For more information see MessageBoxDemo sample.

Inheritance diagram for CBCGPMessageBox:

Public Member Functions
	CBCGPMessageBox	The constructor.
	CBCGPMessageBox	The constructor.
Public Member Functions inherited from CBCGPDialog
	CBCGPDialog	Constructs a CBCGPDialog object
	CBCGPDialog	Constructs a CBCGPDialog object
	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.
	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.
	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.
	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.
	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_bDontUseDefaultIcon	This global flag specifies whether a default icon will be displayed on the message box. By default, this flag is TRUE.
	m_bDrawSpecialAreaOnNC	This global flag specifies whether the button (bottom) area will be filled with an alternate color. By default, this flag is TRUE. Set this flag to FALSE if you don't wish to fill the message box button area with an alternate background color.
	m_bUseNativeCaption	This global flag specifies whether the Windows native caption and border will be used in the message boxes.
	m_bUseNativeControls	This global flag specifies whether the Windows native controls will be used in the message boxes.
	m_bUseNativeIcons	This global flag specifies whether the Windows native icons will be used in the message boxes. By default, the message box displays an MS Office-style icon.
	m_nLimitCaptionWidth	This global flag allows you to limit the dialog width in the case of very long caption text. E.g., if you set this variable to 70, the caption width will be limited by 70 percent of the screen width. If this flag is 0 (the default value), the whole caption text is displayed.
	m_nTextCalculationStep	This global flag specifies the text layout calculation tolerance (in pixels, 10 by default; the allowed range is 5-200). Specify a larger value if you have message boxes with long texts to optimize the dialog initialization time.

Additional Inherited Members
Public Types inherited from CBCGPDialog
enum	BackgroundLocation
Protected Member Functions inherited from CBCGPMessageBoxImpl
	IsDrawButtonsBanner	Tells whether the bottom area around the message box buttons is drawn with a special background.
Protected Attributes inherited from CBCGPDialog
	m_bDisableShadows	Specifies whether the dialog custom shadows should be disabled.