Customization Window

  • 2 minutes to read

Overview

The customization window is an alternative to quick customization that gives an end-user complete control over the toolbar's content and appearance.

To open the customization window, an end-user should select Customize... from the customization menu.

The customization menu appears when an end-user right-clicks a bar.

Customization Menu

The following table lists properties that control the availability of the customization menu for different bar elements.

Property Description
BarManager.AllowCustomization Specifies whether the customization menu is enabled for the current BarManager.
Bar.AllowCustomizationMenu Specifies whether the customization menu is enabled for the current Bar.
ToolBarControlBase.AllowCustomizationMenu Specifies whether the customization menu is enabled for the current ToolBarControlBase descendant.

Adding and Removing Toolbars

The customization window's Toolbars tab allows an end-user to manipulate entire toolbars.

The following image demonstrates the Toolbars tab.

CustomizationWindow

Check boxes displayed to the left of the toolbar names toggle the toolbar visibility.

To add a bar, click New. To delete a bar, select it in the Toolbars list and click Delete. The Rename button allows you to rename a bar.

Adding and Removing Bar Items

The customization window's Commands tab allows end-users to add, remove and copy individual bar items.

To add a specific command to a bar, search for this command in the customization window's Commands page and drag the command to a bar.

NOTE

To learn more about bar item categories, see Categories topic.

CustomizationWindow_CommandsPage

Customizing Individual Bar Items

While the customization window is open, end-users can perform the following actions.

  • Change a bar item's position

    Drag a bar item to the required position.

  • Copy a bar item

    Hold CTRL and drag a bar item to the required position.

  • Remove an item from the toolbar

    Drag a bar item outside the toolbar.

  • Open the item customization menu

    Right-click a bar item.

The following image demonstrates the item customization menu.

BarItemLink_CustomizationMenu

The following table lists the customizations available from the item customization menu.

Menu Item Description
Reset Resets the command's display style to default.
Delete Deletes the command from the bar.
Caption Allows you to modify the command's caption.
Display mode Allows you to modify the command's display style.
Glyph alignment Allows you to change the alignment of the item's glyph.
Glyph size Allows you to change the size of the item's glyph.
Visible Toggles the command's visibility.
Begin a group Specifies whether the item starts a visual group.
See Also