Using the Customization Form
- 2 minutes to read
The Customization Form allows end-users to customize the visibility, layout and appearance aspects of toolbars, create new toolbars and reset the existing toolbars. This topic provides information on how to invoke the Customization Form at runtime.
An end-user can invoke the Customization Form in several ways. Note, if a bar manager’s CanCustomize property is set to False, there is no way for an end-user to customize toolbars. You can also prohibit a certain toolbar from being customized by setting its AllowCustomizing property to False.
- Invoking via code
Calling a bar manager’s Customizing method displays or hides the Customization Form.
- Invoking via the Toolbars Popup Menu
When an end-user right-clicks a toolbar, the Toolbars Popup Menu is invoked. It contains the Customize… item. Clicking it displays the Customization Form. The following picture demonstrates how it can be done:
- Invoking via the Quick Customization Popup Menu
End-users can click the dropdown button at the end of a toolbar. This invokes the Quick Customization Popup Menu in which the Customize… item can be chosen to display the Customization Form.
Note that a toolbar contains this dropdown button when its AllowQuickCustomizing property is set to True, and a bar manager’s Style property isn’t bmsStandard.
- Invoking via double-clicking
If a toolbar doesn’t occupy the entire dock row (its WholeRow property is set to False), an end-user can double-click the remaining dock row region to display the Customization Form.