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.
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. |