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 0004 0005 .. metadata-placeholder 0006 0007 :authors: - digiKam Team 0008 0009 :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html) 0010 0011 .. _toolbars_settings: 0012 0013 Toolbars Settings 0014 ================= 0015 0016 .. contents:: 0017 0018 Toolbar Editor 0019 -------------- 0020 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... 0022 0023 .. figure:: images/setup_toolbars_dialog.webp 0024 :alt: 0025 :align: center 0026 0027 The digiKam Toolbars Configuration Dialog 0028 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. 0030 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. 0032 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. 0034 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. 0036 0037 You can add separator lines between items by adding a **--- separator ---** item to the toolbar. 0038 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. 0040 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. 0042 0043 Customizing Toolbar Appearance 0044 ------------------------------ 0045 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. 0047 0048 .. figure:: images/setup_toolbars_context_menu.webp 0049 :alt: 0050 :align: center 0051 0052 The digiKam Toolbars Context Menu 0053 0054 You can choose from: 0055 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. 0060 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. 0062 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: 0064 0065 - **Small (16x16)**. 0066 - **Medium (22x22)** [the default value]. 0067 - **Large (32x32)**. 0068 - **Huge (48x48)**. 0069 0070 Customize Toolbar Position 0071 -------------------------- 0072 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. 0074 0075 You can change a toolbar's position from the **Orientation** sub-menu of its context menu. 0076 0077 You can choose from: 0078 0079 - **Top** [the default position]. 0080 - **Left**. 0081 - **Right**. 0082 - **Bottom**. 0083 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. 0085 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.