Customization Window

• Apr 01, 2021
• 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.

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.

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.

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.

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.