# Custom Toolbars and Menus

Feature Showcase

- create a custom toolbar

Custom toolbars and menus are used to extend Komodo's default menus and toolbars with menus and toolbars containing custom items. Any component that can be stored in a project or the Toolbox can be stored in a custom toolbar or menu. A custom toolbar might contain frequently used run commands and snippets; a custom menu might contain folders with the contents of a local filesystem.

Custom toolbars and menus are created and configured within the Project Manager and/or the Toolbox. Custom toolbars and menus contained in projects are only displayed when the projects are open in the Projects sidebar; custom toolbars and menus contained in the Toolbox are always displayed.

## Creating Custom Toolbars and Menus

1. On the Project or Toolbox menu, select Add|New Custom Toolbar or Add|New Custom Menu. Enter a name for the new component.
2. Copy and paste or drag and drop the item(s) to be included on the toolbar or menu onto the icon created in the previous step. Alternatively, right-click the custom menu or toolbar name and select Add. For a complete description of adding components to containers (such as projects and custom menus and toolbars), see the Projects section of the documentation. New toolbars are displayed alongside the default Komodo toolbars and can be accessed via the View|Toolbars menu. New menus are displayed to the right of the default Komodo menus.

## Custom Menu and Toolbar Options

To access options for a custom menu or toolbar, do one of the following:

- Toolbox|menuortoolbar_name|option or Project|menuortoolbar_name|option: When a custom menu or toolbar is selected in the Projects sidebar or Toolbox, use the Project or Toolbox menus to access the list of options. The name of the custom menu or toolbar that is currently selected in a project or the Toolbox is displayed on the menu.
- Context Menu: Right-click the custom menu or toolbar in a project or the Toolbox and select the desired option.

The following options are available:

- Export as Project File: When this option is invoked, a new project file is created that contains the custom menu or toolbar from which the option is invoked. You are prompted to provide the name of the new project file and the directory where it will be stored. To open the new project file, select File|Open|Project.
- Export Package: Snippets can be archived and distributed among multiple Komodo users via Packages. Packages are compressed archive files that contain the snippet from which the Export Package option was invoked. Packages are stored in files with a ".kpz" extension, and can be opened by any archiving utility that supports `libz` (for example WinZip). The Export Package option differs from the Export as Project File option in that copies of filesystem-based components (such as files and dialog projects) are included in the archive. Conversely, Export as Project File creates a project with a reference to the component's original location and does not create copies of the components. When Export Package is invoked, you are prompted for a name and file location for the package. Exported packages can only be imported into "container" objects in Komodo, such as projects, the Toolbox, and folders within projects and the Toolbox. See Toolbox - Exporting and Importing Toolbox Contents, Projects - Importing and Exporting Projects via Packages, or Folders - Import Contents from Package for more information.
- Rename: To change the name of a custom menu or toolbar, select this option and enter a new name.
- Cut/Copy/Paste: These options are used to remove the custom menu or toolbar from a project or the Toolbox, or to move custom menu or toolbars between the project and the Toolbox (and vice versa).
- Add: Use this option to add components to the selected custom menu or toolbar. All components can be added to custom menu or toolbars in the same manner they are added to projects. Refer to the individual component documentation, or the project documentation for more information.
- Delete: To remove a custom menu or toolbar from a project or the Toolbox, select this option. The custom menu or toolbar is permanently deleted.

### Custom Menu and Toolbar Properties

Custom menu or toolbar properties are used to alter the name of the custom menu or toolbar, or change the custom menu or toolbar's display order. To access the Properties dialog box, right-click the custom menu or toolbar and select Properties.

Custom menus are displayed between the default Tools and Window menus. If multiple custom menus are in effect, the display order depends on the menu's Priority setting. New menus have a default priority of 100; alter the priority of custom menus to control the left-to-right order of display.

Custom toolbars are displayed to the right of default Komodo toolbars. If necessary, a new row is created for their display. If multiple custom toolbars are in effect, the display order depends on the toolbar's Priority setting. New toolbars have a default priority of 100; alter the priority of custom toolbars to control the left-to-right order of display.

To assign a letter to be used in combination with the 'Alt' key for menu access, enter a shortcut letter in the Menu Access Key field. If the letter is already assigned to a Komodo core function, you are prompted to enter a different letter.