CMFCToolBarsCustomizeDialog Class

Article
01/08/2013

A modeless tab dialog box (CPropertySheet Class) that enables the user to customize the toolbars, menus, keyboard shortcuts, user-defined tools, and visual style in an application. Typically, the user accesses this dialog box by selecting Customize from the Tools menu.

The Customize dialog box has six tabs: Commands, Toolbars, Tools, Keyboard, Menu, and Options.

class CMFCToolBarsCustomizeDialog : public CPropertySheet

Members

Public Constructors

Name	Description
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog	Constructs a CMFCToolBarsCustomizeDialog object.
CMFCToolBarsCustomizeDialog::~CMFCToolBarsCustomizeDialog	Destructor.

Public Methods

Name	Description
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog::AddButton	Inserts a toolbar button into the list of commands on the Commands page
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog::AddMenu	Loads a menu from the resources and calls CMFCToolBarsCustomizeDialog::AddMenuCommands to add that menu to the list of commands on the Commands page.
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog::AddMenuCommands	Loads a menu from the resources and calls CMFCToolBarsCustomizeDialog::AddMenuCommands to add that menu to the list of commands on the Commands page.
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog::AddToolBar	Loads a toolbar from the resources. Then, for each command in the menu calls the CMFCToolBarsCustomizeDialog::AddButton method to insert a button in the list of commands on the Commands page under the specified category.
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog::Create	Displays the Customization dialog box.
CMFCToolBarsCustomizeDialog::EnableTools	Reserved for future use.
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog::EnableUserDefinedToolbars	Enables or disables creating new toolbars by using the Customize dialog box.
CMFCToolBarsCustomizeDialog::FillAllCommandsList	Populates the provided CListBox object with the commands in the All Commands category.
CMFCToolBarsCustomizeDialog::FillCategoriesComboBox	Populates the provided CComboBox object with the name of each command category in the Customize dialog box.
CMFCToolBarsCustomizeDialog::FillCategoriesListBox	Populates the provided CListBox object with the name of each command category in the Customize dialog box.
CMFCToolBarsCustomizeDialog::GetCommandName	Retrieves the name that is associated with the given command ID.
CMFCToolBarsCustomizeDialog::GetCountInCategory	Retrieves the number of items in the provided list that have a given text label.
CMFCToolBarsCustomizeDialog::GetFlags	Retrieves the set of flags that affect the behavior of the dialog box.
CMFCToolBarsCustomizeDialog::GetThisClass	Used by the framework to obtain a pointer to the CRuntimeClass object that is associated with this class type.
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog::OnEditToolbarMenuImage	Starts an image editor so that a user can customize a toolbar button or menu item icon.
CMFCToolBarsCustomizeDialog::OnInitDialog	Overrides to augment property sheet initialization. (Overrides CPropertySheet::OnInitDialog.)
CMFCToolBarsCustomizeDialog::PostNcDestroy	Called by the framework after the window has been destroyed. (Overrides CPropertySheet::PostNcDestroy.)
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog::RemoveButton	Removes the button with the specified command ID from the specified category, or from all categories.
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog::RenameCategory	Renames a category in the list box of categories on the Commands tab.
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog::ReplaceButton	Replaces a button in the list of commands on the Commands tab with a new toolbar button object.
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog::SetUserCategory	Adds a category to the list of categories that will be displayed on the Commands tab.

Protected Methods

Name	Description
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog::CheckToolsValidity	Called by the framework to determine whether the list of user-defined tools is valid.
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog::OnAfterChangeTool	Called by the framework when the properties of a user-defined tool change.
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog::OnAssignKey	Determines whether a specified keyboard shortcut can be assigned to an action.
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog::OnBeforeChangeTool	Determines whether a user-defined tool can be changed.
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog::OnInitToolsPage	Called by the framework when the user chooses the Tools tab is requested.

Remarks

To display the Customize dialog box, create a CMFCToolBarsCustomizeDialog object and call the CMFCToolBarsCustomizeDialog::Create method.

While the Customize dialog box is active, the application works in a special mode that limits the user to customization tasks.

Example

The following example demonstrates how to use various methods in the CMFCToolBarsCustomizeDialog class. The example shows how to replace a toolbar button in the list box of commands on the Commands page, enable creating new toolbars by using the Customize dialog box, and display the Customization dialog box. This code snippet is part of the IE Demo sample.

 pDlgCust->ReplaceButton (ID_FAVORITS_DUMMY,
        CMFCToolBarMenuButton ((UINT)-1, menuFavorites, -1, strFavorites));
    pDlgCust->EnableUserDefinedToolbars();
    pDlgCust->Create ();