# The Toolbar and Keyboard Shortcuts

This chapter describes miscellaneous time-saving and convenience features available in &kst;.

## The Toolbar

The toolbar provides one-click access to commonly used menu functions in &kst;. To toggle the toolbar, select Show Toolbar from the Settings menu.

### The Toolbar Menu

The toolbar menu, accessible by right-clicking anywhere on the toolbar, contains functions for modifying the layout, appearance, and behaviour of the toolbar. The three submenus available are described below.

#### Orientation

The Orientation submenu contains layout options for the toolbar.

Top, Left, Right, and Bottom

  Docks the toolbar at the corresponding edge of the &kst; window.

Flat

  Hides the toolbar and turns it into a slim bar at the top of &kst; window. To unhide the toolbar, click on the gripper that is still visible.

You can also move the toolbar by dragging the gripper on the edge of the toolbar. Dragging the toolbar close to an edge of the &kst; window docks it. Dragging the toolbar anywhere else turns it into a floating toolbar.

#### Text Position

The Text Position submenu specifies if and how text and icons should be displayed on the toolbar.

Icons Only

  Does not display any text labels and only displays icons. However, the text for each icon is still available as a tooltip associated with the icon (viewable by momentarily holding the cursor of the icon).

Text Only

  Does not display any icons on the toolbar, but displays all text labels.

Text Alongside Icons

  Displays all icons. Text labels are displayed to the right of the icons.

Text Under Icons

  Displays all icons. Text labels are displayed underneath the icons.

#### Icon Size

The Icon Size submenu specifies the size of the icons on the toolbar. Select a size from the submenu, or select Default to use the default size (usually the same as Medium). The options in this menu do not have any effect if Text Only is selected for Text Position.

## Custom Shortcut Keys

You can create custom shortcut keys to make working in &kst; more efficient. To modify the shortcut keys, select Configure Shortcuts... from the Settings menu. The following dialog will be displayed.

Configure Shortcuts Window
Configure Shortcuts Window

A list of available actions and their associated shortcuts are shown in the dialog. Each action is allowed two shortcuts—a primary shortcut and an alternate shortcut. Either shortcut can be used at any time. To define or change a shortcut for an action, simply highlight the appropriate row in the shortcut list. Under Shortcut for Selected Action, there are three choices:

None

  Select this option to disable any shortcut keys for the selected action.

Default

  Select this option to use the default shortcut key(s) for the selected action. Note that not all actions have default shortcuts defined.

Custom

  Select this option to define a custom shortcut for the selected action.

If you select the Custom option, the Define Shortcut dialog will appear (alternatively, you can also click on the key-shaped button to open the dialog).

Define Shortcut Window
Define Shortcut Window

By default, the Auto-close option is checked, so once a key combination is entered, the key combination will be automatically saved and the dialog closed. You can uncheck this option if you wish to experiment with the dialog.

To define a key combination, select Primary or Alternate. If you wish to define a key sequence, check the Multi-key option. Now enter the key combination or sequence to be used for this action. Click OK when you are done.

When using shortcuts defined with the multi-key option, a small menu is displayed after the first key of the shortcut is pressed, showing the possible shortcut key completions. Pressing additional keys of the shortcut further filters the list. This list can be a useful reminder of the defined shortcuts.

The action associated with a multi-key shortcut is performed as soon as only one action matches the keys pressed so far. For example, if a multi-key shortcut of ABC is defined, and no other multi-key shortcuts are defined, the action associated with the shortcut will be performed as soon as A is pressed.