BCGControlBar Pro for MFC
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

 CBCGPLightBoxDialogConstructs a CBCGPLightBoxDialog object from the dialog resource template
 
 CBCGPLightBoxDialogConstructs a CBCGPLightBoxDialog object from the dialog resource template
 
 CBCGPLightBoxDialogConstructs a CBCGPLightBoxDialog object without dialog resource template.
 
- Public Member Functions inherited from CBCGPAnimationManager
 CBCGPAnimationManagerDefault constructor.
 
 GetAnimatedValueGets current animated value.
 
 GetAnimationDurationGets animation duration.
 
 GetLastAnimationErrorGets the animation error returned by recent call to Windows Animation API.
 
 IsAnimatedChecks if animation is running.
 
 StartAnimationStarts an animation.
 
 StartFlashAnimationStarts "flash" animation.
 
 StopAnimationStops an animation.
 

Public Attributes

 m_LightBoxOptionsLightBox dialog options.
 

Additional Inherited Members

- Public Types inherited from CBCGPAnimationManager
enum  BCGPAnimationType
 
- Static Public Member Functions inherited from CBCGPAnimationManager
 IsAnimationSupportedByOSChecks if animation is supported by OS.
 
- Protected Member Functions inherited from CBCGPAnimationManager
 OnAnimationIdleCalled by the framework in an animation idle time.