CBCGPFileDialogEx

Detailed Description

The CBCGPFileDialogEx class implements Windows-like File Dialog. In general, API of this class is very similar to CFileDialog, but all customization methods (like adding custom controls) are not implemented "out of the box" and should be developed in derived classes (we demonstrate this approach in our ThemedFileDialog and SVGViewDemo samples).

To use this dialog in the standard ID_FILE_OPEN or ID_FILE_SAVE command handlers, simply set m_bThemedFileDialog to TRUE in your application class constructor

Inheritance diagram for CBCGPFileDialogEx:

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

Protected Member Functions
	GetFilePanePlaceHolderID	Returns a File Pane place holder dialog resource ID. Should be implemented in CBCGPFileDialogEx-derived class with custom dialog resource:
	OnFolderChange	Called by the framework when a current folder was changed.
	OnItemSelectionChanged	Called by the framework when a file list selection is changed.
	OnTypeChange	Called by the framework when a current file type was changed.

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.