// Copyright (C) 2026 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
    \page creator-how-to-use-zen-mode.html
    \previouspage creator-how-tos.html

    \ingroup creator-how-to-ui

    \title Use Zen Mode

    By default, the \uicontrol Edit mode shows a mode selector (1), as well as
    left and right sidebars (2 and 3).

    \image {qtcreator-zen-mode-off.webp} {Edit mode with mode selector and sidebars}
    \caption Edit mode with mode selector and sidebars visible.

    The Zen Mode extension provides modes that hide UI elements so you
    can focus on editing code.

    Activate the \uicontrol {Zen Mode} extension in \preferences >
    \uicontrol Extensions > \uicontrol Browse. For more information about
    extensions, see \l {Activate extensions}.

    \section1 Toggle distraction free mode

    The distraction free mode closes the mode selector (1), left and right
    sidebar (2 and 3), and other views.

    \image {qtcreator-distraction-free-mode-on.webp} {Distraction free mode on}
    \caption Distraction free mode on.

    To toggle the distraction free mode:

    \list
        \li Select \inlineimage {icons/distraction-free-mode.png} {Distraction Free Mode}.
        \li Go to \uicontrol Tools > \uicontrol {Zen Mode}, and select
            \uicontrol {Toggle Distraction Free Mode}.
        \li Select \key {Shift+Esc}.
    \endlist

    \section1 Toggle zen mode

    The zen mode closes the mode selector (1), left and right sidebar (2 and 3)
    and other views, switches \QC to full screen, and hides the main menu bar.

    \image {qtcreator-zen-mode-on.webp} {Zen mode on}
    \caption Zen mode on.

    To toggle the zen mode:

    \list
        \li Select \inlineimage {icons/zenmode.png} {Zen Mode}.
        \li Go to \uicontrol Tools > \uicontrol {Zen Mode}, and select
            \uicontrol {Toggle Zen Mode}.
        \li Press \key {Alt+Shift+Z}.
    \endlist

    \section1 Set Zen Mode preferences

    To set preferences for the Zen Mode extension, go to \preferences >
    \uicontrol {Zen Mode}.

    \image {qtcreator-preferences-zen-mode.webp} {Zen Mode preferences}

    You can set the width of the editor content area and configure
    the appearance of the mode selector while the modes are active.

    \sa {Adapt the UI}{How to: Adapt the UI}
*/
