CBCGPWinApp

Detailed Description

CBCGPWinApp class is derived from CWinApp and simplifies creation of new applications. CBCGPWinApp provides developers with the following functionality:

• Automatic initializing Context Menu, Keyboard, Shell and Tooltip managers
• Switching between Visual Themes
• Associating Visual Theme with a specific menu/ribbon item.
• Auto-saving recent Visual Theme in the application registry branch.
• More simple toolbar/menu customization: you've to setup CBCGPToolbarOptions m_ToolbarOptions in the application class constructor and rest will be handled by the framework.
• Auto-cleanup framework data on exit.

Inheritance diagram for CBCGPWinApp:

Public Types
enum	BCGP_VISUAL_THEME

Public Member Functions
	AddVisualTheme	Adds a visual theme (manager) to the application
	ExitInstance	Called by the framework from within the Run member function to exit this instance of the application.
	GetApplicationLookMenuCommandID	Gets menu item ID that will be replaced with a visual themes list.
	GetCommandIDVisualTheme	Gets a visual theme associated with command identifier.
	GetToolbarOptions	Return a reference to application toolbar options object
	GetVisualTheme	Returns a currently activated Visual Theme
	GetVisualThemeCommandID	Gets visual theme command identifier.
	InitInstance	This method is called by the framework to initialize the application or DLL instance.
	IsThemedFileDialog	Tells whether a themed File Dialog is used instead of the standard Windows File Dialog.
	LoadSystemLibrary	Called by the framework when a standard (system) DLL is being loaded.
	SetApplicationLookMenu	Specifies a menu item that will be replaced with a visual themes list.
	SetToolbarOptions	Sets toolbar options.
	SetVisualTheme	Call this method to change the Visual Theme.
Public Member Functions inherited from CBCGPWorkspace
	CBCGPWorkspace	Constructs a CBCGPWorkspace object.
	CleanState	Removes the workspace state from the Windows registry.
	CreateScreenshot	Creates a given window screenshot.
	EnableLoadKeyboardAccelerators	Enables or disables loading of keyboard accelerators along with other settings.
	EnableLoadWindowPlacement	Enables or disables loading of main frame size and position along with other settings.
	EnableTaskBarInteraction	Enables interaction with Windows 7-11 task bar.
	EnableTearOffMenus	Enables using of tear-off menus in application.
	EnableUserTools	Enables user-defined plug-ins (user tools) in the application.
	GetBinary	Retrieves the binary data for a specified value field.
	GetContextMenuManager	Gives the access to the global CBCGPContextMenuManager object.
	GetDataVersionMajor	Returns the major version of the workspace state saved in the Windows registry.
	GetDataVersionMinor	Returns the minor version of the workspace state saved in the Windows registry.
	GetDouble	Retrieves the double data for a specified value field.
	GetInt	Retrieves the numeric data for a specified value field.
	GetKeyboardManager	Gives the access to the global CBCGPKeyboardManager object
	GetMouseManager	Gives the access to the global CBCGPMouseManager object.
	GetObject	Retrieves the CObject - derived object data for a specified value field.
	GetRegistryBase	Gets a path to the registry key, which serves as a root for all subsequent registry calls.
	GetRegSectionPath	Concatenates the relative path to a registry key with the application path.
	GetSectionBinary	Retrieves the binary data for a specified value field of a specified key.
	GetSectionDouble	Retrieves the numeric data for a specified value field of a specified key.
	GetSectionInt	Retrieves the numeric data for a specified value field of a specified key.
	GetSectionObject	Retrieves the CObject - derived object data for a specified value field of a specified key.
	GetSectionString	Retrieves the string data for a specified value field of a specified key.
	GetShellManager	Gives the access to the global CBCGPShellManager object.
	GetString	Retrieves the string data for a specified value field.
	GetTooltipManager	Returns a pointer to the tooltip manager.
	GetUserToolsManager	Gives the access to the global CBCGPUserToolsManager object.
	InitContextMenuManager	Initializes the context menu manager.
	InitKeyboardManager	Initializes the keyboard manager.
	InitMouseManager	Initializes the mouse manager.
	InitShellManager	Initializes the shell manager
	InitTooltipManager	Initializes the tooltip manager.
	IsStateExists	Determines whether the specified state does exist or not.
	IsTaskBarInteractionEnabled	Tells whether interaction with Windows 7-11 task bar is enabled or disabled.
	LoadState	Loads the application state from the Windows registry.
	LoadState	Loads the application state from the Windows registry.
	LoadState	Loads the application state from the Windows registry.
	OnAppContextHelp	Called by the framework in customization mode to invoke context help.
	OnEditCtrlContextMenu	Called by the framework when edit control's context menu should be displayed.
	OnViewDoubleClick	Invokes a user-defined command that has been associated with a double-click the left mouse button.
	SaveState	Stores the framework's state into the Windows registry.
	SaveState	Stores the framework's state into the Windows registry.
	SaveState	Stores the framework's state into the Windows registry.
	SaveState	Stores the framework's state into the Windows registry.
	SetRegistryBase	Sets a path to the registry key that will serve as a root for all subsequent registry calls.
	ShowPopupMenu	Displays a popup menu.
	WriteBinary	Stores binary data in a specified value field.
	WriteDouble	Stores double data in a specified value field.
	WriteInt	Stores numeric data in a specified value field.
	WriteObject	Stores CObject - derived object data in a specified value field.
	WriteSectionBinary	Stores binary data in a specified value field of a specified key.
	WriteSectionDouble	Stores numeric data in a specified value field of a specified key.
	WriteSectionInt	Stores numeric data in a specified value field of a specified key.
	WriteSectionObject	Stores CObject - derived object data in a specified value field of a specified key.
	WriteSectionString	Stores string data in a specified value field of a specified key.
	WriteString	Stores string data in a specified value field.

Protected Member Functions
	CreateFileDialog	This method is called by the framework when a themed File Dialog should be created.
	OnAfterChangeVisualTheme	This method is called by the framework after changing the Visual Theme.
	OnBeforeChangeVisualTheme	This method is called by the framework before changing the Visual Theme.
	OnBeforeCreateCustomizationDlg	This method is called by the framework before create customization dialog action.
	OnCustomizeToolBars	This method is called by the framework when user chooses "Customize..." menu item from "Toolbars" menu.
Protected Member Functions inherited from CBCGPWorkspace
	LoadCustomState	Called by the framework when the BCGControlBar Library-related application state has been loaded.
	LoadWindowPlacement	Called by the framework before a creation of the window attached to a CWnd object to load the window placement information from the registry.
	OnClosingMainFrame	Called by the framework when a main frame window is processing WM_CLOSE message.
	PreLoadState	Called by the framework before the application state is loaded.
	ReloadWindowPlacement	Reloads window size and position from the registry
	SaveCustomState	Called by the framework after everything is stored into the Windows registry.
	StoreWindowPlacement	Called by the framework to save the window placement information to registry when the window frame is being closed.

Protected Attributes
	m_ActiveTheme	Application Visual Theme
	m_AppOptions	General Application options
	m_bContextMenuManager	Specifies whether an application should initialize a context menu manager
	m_bDPIAware	Set this member to TRUE to make your application DPI aware.
	m_bDPIAwareTooltips	Set this member to TRUE to enable DPI-aware tooltips.
	m_bThemedFileDialog	Specifies whether a themed File Dialog is used instead of the standard Windows File Dialog.
	m_bThemedMessageBox	Set this member to FALSE to disable themed message boxes (displayed By AfxMessageBox).
	m_bThemedTooltips	Set this member to TRUE to enable themed tooltips.
	m_FileDialogOptions	The themed File Dialog options.
Protected Attributes inherited from CBCGPWorkspace
	m_bAutoSyncControlBarsStateBetweenFrames	Specifies whether the frame state should be automatically synchronized (in the multiple top-level document interface applications).
	m_bForceImageReset	Force image reset every time when the frame is loaded

Additional Inherited Members
Static Public Member Functions inherited from CBCGPWorkspace
	UseWorkspaceManager	Enables workspace manager for an application.
Public Attributes inherited from CBCGPWorkspace
	m_bIsAeroSnapPlacement	If this memebr is TRUE, the fraework saves the recent frame position and size in "AeroSnap" mode.
	m_nFileNewFrameCommandID	Specifies the command ID associated with new frame creation (in the multiple top-level document interface applications, usually ID_FILE_NEW_FRAME).