# Customizing &kde; software

&TC.Hollingsworth; &TC.Hollingsworth.mail;

## Customizing Toolbars

The &gwenview; Toolbar
The &gwenview; toolbar.

The toolbar in &gwenview;.

### Modifying Toolbar Items

To customize an application's toolbars, go to Settings Configure Toolbars... or right-click on a toolbar and select Configure Toolbars....

On the left side of the toolbar configuration panel, the available items that you can put in your toolbar are shown. On the right, the ones that already appear on the toolbar are shown. At the top, you can select the toolbar you wish to modify or view.

Above each side of the panel there is a Filter text box you can use to easily find items in the list.

The Customize Toolbars Window
The Customize Toolbars window.

The Customize Toolbars window in &gwenview; with the Previous button selected.

#### Adding an Item

You can add an item to your toolbar by selecting it from the left side and clicking on the right arrow button.

#### Removing an Item

You can remove an item by selecting it and clicking the left arrow button.

#### Changing the Position of Items

You can change the position of the items by moving them lower or higher in the list. To move items lower, press the down arrow button, while to move items higher press the up arrow button. You can also change items' position by dragging and dropping them.

On horizontal toolbars, the item that's on top will be the one on the left. On vertical toolbars, items are arranged as they appear in the toolbar.

#### Adding a Separator

You can add separator lines between items by adding a --- separator --- item to the toolbar.

#### Restoring Defaults

You can restore your toolbar to the way it was when you installed the application by pressing the Defaults button at the bottom of the window and then confirming your decision.

#### Changing Text and Icons

You can change the icon and text of individual toolbar items by selecting an item and clicking either the Change Icon... or Change Text... button.

### Customizing Toolbar Appearance

You can change the appearance of toolbars by right-clicking on a toolbar to access it's context menu.

#### Text Position

You can change the appearance of text on toolbars in the Text Position submenu of a toolbar's context menu.

You can choose from:

- Icons - only the icon for each toolbar item will appear.

- Text - only the text label for each toolbar item will appear.

- Text Alongside Icons - the text label will appear to the right of each toolbar item's icon

- Text Under Icons - the text label will appear underneath each toolbar item's icon

You can also show or hide text for individual toolbar items by right-clicking on an item and checking or unchecking the item under Show Text.

#### Icon Size

You can change the size of toolbar items' icons by selecting Icon Size from the toolbar's context menu.

You can choose from the following options: (each lists the icon size in pixels)

- Small (16x16)

- Medium (22x22) [the default value]

- Large (32x32)

- Huge (48x48)

#### Moving Toolbars

In order to move toolbars, you must unlock them. To do so, uncheck Lock Toolbar Positions from a toolbar's context menu. To restore the lock, simply recheck this menu item.

You can change a toolbar's position from the Orientation submenu of its context menu.

You can choose from:

- Top [the default in many applications]

- Left

- Right

- Bottom

You can also move a toolbar by clicking and holding onto the dotted line at the left of horizontal toolbars or the top of vertical toolbars and dragging it to your desired location.

#### Show/Hide Toolbars

If your application has only one toolbar, you can hide a toolbar by deselecting Show Toolbar from either the toolbar's context menu or the Settings menu. To restore the toolbar, select Show Toolbar from the Settings menu. Note that toolbars must be unlocked to hide them from their context menu; see for more information.

If your application has more than one toolbar, a submenu called Toolbars Shown will appear in the context menu and Settings menu instead of the above menu entry. From that menu you may select individual toolbars to hide and show.

### Thanks and Acknowledgments

Thanks to an anonymous Google Code-In 2011 participant for writing much of this section.

Alexey
Subach
&TC.Hollingsworth; &TC.Hollingsworth.mail;

## Using and Customizing Shortcuts

### Introduction

Many &kde; applications allow you to configure keyboard shortcuts. To open the standard keyboard shortcuts configuration panel, go to Settings Configure Shortcuts....

In the Configure Shortcuts window, you will see a list of all the shortcuts available in the current application. You can use the search box at the top to search for the shortcut you want.

The Customize Shortcuts Window
The Customize Shortcuts window.

Searching for shortcuts with `file` in &dolphin;.

### Changing a Shortcut

To change a shortcut, first click on the name of a shortcut you want to change. You will see a radio group where you can choose whether to set the shortcut to its default value, or select a new shortcut for the selected action. To set a new shortcut, choose Custom and click on the button next to it. Then just type the shortcut you would like to use, and your changes will be saved.

Setting a Shortcut
The Customize Shortcuts window demonstrating how to set a shortcut.

### Resetting Shortcuts

There is a button at the bottom of the window, called Reset to Defaults. Clicking on this button will reset all your custom shortcuts to their default values.

You can also reset an individual shortcut to its default value by selecting it, and choosing the Default radio button.

### Removing a Shortcut

To remove a shortcut, select it from the list, then click the remove icon (a black arrow with a cross) to the right of the button that allows you to select a shortcut.

### Working with Schemes

Schemes are keyboard shortcuts configuration profiles, so you can create several profiles with different shortcuts and switch between these profiles easily.

This feature is under development. It is not possible to import schemes using a &GUI; at this time.

Working with Schemes
The Customize Shortcuts window displaying the scheme editing tools.

Editing a scheme called `work`.

To see a menu allowing you to edit schemes, click on the Details button at the bottom of the form. The following options will appear:

Current Scheme

  Allows you to switch between your schemes.

New...

  Creates a new scheme. This opens a window that lets you select a name for your new scheme.

Delete

  Deletes the current scheme.

More Actions

  Opens the following menu:

  Save as Scheme Defaults

    Sets the current scheme as the default for all new schemes.

  Export Scheme...

    Exports the current scheme to a file named `applicationnameschemenameshortcuts.rc`.

    Move this file to the folder `$KDEDIR/apps/applicationname/` and the exported scheme will be available in the drop down box labelled Current Scheme

### Printing Shortcuts

You can print out a list of shortcuts for easy reference by clicking the Print button at the bottom of the window.

### Thanks and Acknowledgments

Special thanks to Google Code-In 2011 participant Alexey Subach for writing much of this section.