CBCGPLightBoxDialog

Detailed Description

The LightBox dialog look and functionality are very similar to Web/Mobile Light Boxes. This is either modal or modeless window created on top of the application's window. The area around this window is automatically darken and all child windows of the application frame are disabled. Therefore, user concentrates attention on the active dialog only.

The customer may resize, move or minimize the application frame when the light box dialog is active. If there is not enough space to display a whole dialog inside the application's frame, the dialog became smaller and, if window has WS_HSCROLL/WS_VSCROLL style(s), the scrollbars will appear. The light box dialog is closed when user clicks outside of this window (on the dark area of the application's window).

How to create Light Box Dialog:

1. The process is the same as in case of CDialog, CDialogEx or CBCGPDialog, but you've to derive your dialog class from CBCGPLightBoxDialog.
2. To avoid child controls flickering, we suggest to set WS_CLIPCHILDREN and WS_CLIPSIBLINGS styles in the dialog resource.
3. You may configure the Light Box Dialog appearance and behavior by modifying m_LightBoxOptions members in the class's constructor.

Light Box Dialog customization:

1. By default, the dialog is created in the center of application's window, but you may put it on the left, right, top or bottom of the frame.
2. You may choose show/dismiss transition effects or disable this transition.
3. Color and alpha of the application's "dark" area are fully customizable.
4. You may allow/disallow closing the dialog upon clicking outside the window.

Limitations:

1. You cannot create multiple light box dialogs at the same time.
2. The light box dialog is not resizable and not movable.
3. If light box dialog is created in the Ribbon-based application with Office 2007 style, the application button ("pearl") will be partially shaded.

See also

CBCGPDialog

Inheritance diagram for CBCGPLightBoxDialog:

Public Member Functions
	CBCGPLightBoxDialog	Constructs a CBCGPLightBoxDialog object from the dialog resource template
	CBCGPLightBoxDialog	Constructs a CBCGPLightBoxDialog object from the dialog resource template
	CBCGPLightBoxDialog	Constructs a CBCGPLightBoxDialog object without dialog resource template.
Public Member Functions inherited from CBCGPAnimationManager
	CBCGPAnimationManager	Default constructor.
	GetAnimatedValue	Gets current animated value.
	GetAnimationDuration	Gets animation duration.
	GetLastAnimationError	Gets the animation error returned by recent call to Windows Animation API.
	IsAnimated	Checks if animation is running.
	StartAnimation	Starts an animation.
	StartFlashAnimation	Starts "flash" animation.
	StopAnimation	Stops an animation.

Public Attributes
	m_LightBoxOptions	LightBox dialog options.

Additional Inherited Members
Public Types inherited from CBCGPAnimationManager
enum	BCGPAnimationType
Static Public Member Functions inherited from CBCGPAnimationManager
	IsAnimationSupportedByOS	Checks if animation is supported by OS.
Protected Member Functions inherited from CBCGPAnimationManager
	OnAnimationIdle	Called by the framework in an animation idle time.