.. include:: imagerefs.txt

===========
Preferences
===========

KDXplore preference settings appear contextually throughout the general user interface of KDXplore in each plug-in. However, there is also a **Preferences Window** that contains options for all of KDXplore. To access the **Preferences Window** in KDXplore, select the **File Menu** and then the |preferences| **Preferences Button** as seen in the image below:

|br|

 .. only:: html

     |center-start|

     .. thumbnail:: images/PreferencesExtras/Preferences1.png
         :show_caption: true
         :width: 30%
         :align: center
         :title: Navigating to the Preferences Window

     |center-end|


 .. only:: latex

    .. figure:: images/PreferencesExtras/Preferences1.png
       :scale: 30 %
       :alt: Navigating to the Preferences Window

   Navigating to the Preferences Window

|br|

The **Preferences Window** (as seen in the below image) will be displayed.

|br|

.. only:: html

    |center-start|

    .. thumbnail:: images/PreferencesExtras/PreferencesImage15.png
        :show_caption: true
        :width: 80%
        :align: center
        :title: Preferences Window

    |center-end|


.. only:: latex

    .. figure:: images/PreferencesExtras/PreferencesImage15.png
       :scale: 80 %
       :alt: Preferences Window

   Preferences Window

|br|





Preferences Window
==================

KDXplore preferences are organised in a hierarchy, where preferences are grouped based on general KDXplore preferences, or preferences for specific plug-ins. Sub-groups exist within these groups to further organise preferences such as barcode and UI sub-groups within the general KDXplore preferences.

|br|

.. only:: html

    |center-start|

    .. thumbnail:: images/PreferencesExtras/PreferencesImage17.png
        :show_caption: true
        :width: 80%
        :align: center
        :title: Preference Sub-Groups

    |center-end|


.. only:: latex

    .. figure:: images/PreferencesExtras/PreferencesImage17.png
       :scale: 80 %
       :alt: Preference Sub-Groups

   Preference Sub-Groups

|br|

.. list-table:: Navigating the Preferences Window
   :widths: 1 70
   :header-rows: 1


   * - Step
     - Action
   * - **1.**
     - Select the **+/- Button** next to a preference group as seen in |circle1| to expand/collapse the group. *Double-clicking* will perform the same action.
   * - **2.**
     - Sub-groups applicable to a plug-in will now be visible. Selecting a sub-group (|circle1|) displays the preferences within that sub-group as seen at |circle2| in the above image.
   * - **3.**
     - Further expanding the sub-group structure will present the preferences. Selecting a preference (as seen below in |circle4|) will display controls in |circle5| for altering the selected preference. In the example below a colour preference has been selected.
   * - **4.**
     - Change the preference to whatever is needed and then select the |confirm_btn| **Confirm Button** to confirm the preference change.

|br|

.. only:: html

    |center-start|

    .. thumbnail:: images/PreferencesExtras/PreferencesImage18.png
        :show_caption: true
        :width: 80%
        :align: center
        :title: Editing a Preference

    |center-end|


.. only:: latex

  .. figure:: images/PreferencesExtras/PreferencesImage18.png
     :scale: 80 %
     :alt: Editing a preference in KDXplore

     Editing a Preference

|br|

Resetting to Default
====================

KDXplore preferences can also be reset to the default settings. This can be done by selecting the **Reset Button** as seen in |circle1| on any of the preferences that have been changed.

|br|

.. only:: html

    |center-start|

    .. thumbnail:: images/PreferencesExtras/PreferencesImage19.png
        :show_caption: true
        :width: 80%
        :align: center
        :title: Resetting Preferences to Default

    |center-end|


.. only:: latex

    .. figure:: images/PreferencesExtras/PreferencesImage19.png
       :scale: 80 %
       :alt: Resetting Preferences to Default

       Resetting Preferences to Default

|br|