Warning, /documentation/digikam-doc/setup_application/toolbars_settings.rst is written in an unsupported language. File is not indexed.

0001 .. meta::
0002    :description: digiKam Toolbars Settings
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, camera, configuration, setup, toolbar
0005 .. metadata-placeholder
0007    :authors: - digiKam Team
0009    :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html)
0011 .. _toolbars_settings:
0013 Toolbars Settings
0014 =================
0016 .. contents::
0018 Toolbar Editor
0019 --------------
0021 digiKam interface can be customized with toolbar located below the main menu. An editor is available from the :menuselection:`Settings --> Configure Toolbars` main menu item or right-click on a toolbar and select Configure Toolbars...
0023 .. figure:: images/setup_toolbars_dialog.webp
0024     :alt:
0025     :align: center
0027     The digiKam Toolbars Configuration Dialog
0029 On the left side of the toolbar configuration dialog, 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. Above each side of the panel there is a Filter text box you can use to easily find items in the list.
0031 You can add an item to your toolbar by selecting it from the left side and clicking on the right arrow button. You can remove an item by selecting it and clicking the left arrow button.
0033 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.
0035 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.
0037 You can add separator lines between items by adding a **--- separator ---** item to the toolbar.
0039 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 dialog and then confirming your decision.
0041 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.
0043 Customizing Toolbar Appearance
0044 ------------------------------
0046 You can change the appearance of toolbars by right-clicking on a toolbar to access it's context menu. The **Text Position** sub-menu allows to customize the button icon and title on the toolbar.
0048 .. figure:: images/setup_toolbars_context_menu.webp
0049     :alt:
0050     :align: center
0052     The digiKam Toolbars Context Menu
0054 You can choose from:
0056     - **Icons**: only the icon for each toolbar item will appear.
0057     - **Text**: only the text label for each toolbar item will appear.
0058     - **Text Alongside Icons**: the text label will appear to the right of each toolbar item's icon.
0059     - **Text Under Icons**: the text label will appear underneath each toolbar item's icon.
0061 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.
0063 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 sizes in pixels:
0065     - **Small (16x16)**.
0066     - **Medium (22x22)** [the default value].
0067     - **Large (32x32)**.
0068     - **Huge (48x48)**.
0070 Customize Toolbar Position
0071 --------------------------
0073 In order to move toolbar, 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.
0075 You can change a toolbar's position from the **Orientation** sub-menu of its context menu.
0077 You can choose from:
0079     - **Top** [the default position].
0080     - **Left**.
0081     - **Right**.
0082     - **Bottom**.
0084 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.
0086 You can hide the 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 toolbar must be “unlocked” to hide them from their context menu.