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

/*!
    \page creator-open-documents-view.html

    \if defined(qtdesignstudio)
    \previouspage creator-file-system-view.html
    \nextpage studio-content-library.html
    \else
    \previouspage creator-reference.html
    \endif

    \ingroup creator-reference-sidebar-views
    \ingroup studio-views

    \title Open Documents

    \if defined(qtdesignstudio)
    \brief View currently open files.
    \else
    \brief Shows currently open files.
    \endif

    \if defined(qtdesignstudio)
    \image open-documents-view.webp {Open Documents view}
    \else
    \image qtcreator-open-documents-view.png {Open Documents view}
    \endif

    You can use the context menu to apply some of the functions also available
    in the \uicontrol File menu and in the
    \if defined(qtcreator)
    \l {File System Context Menu}{File System}
    \else
    \uicontrol {File System}
    \endif
    view to the file that you select in the view.

    In addition, you can:

    \list
        \li Copy the full path of the file or just the filename to the
            clipboard.
        \li Pin files to the top of the list to keep them open when you
            select \uicontrol {Close All}.
        \li Assign keyboard shortcuts for opening the next and previous
            document in the list (\uicontrol OpenNextDocument and
            \uicontrol OpenPreviousDocument).
    \endlist

    \section1 Setting Preferences for Opening Files

    To set preferences for opening files and handling open files, select
    \preferences > \uicontrol Environment > \uicontrol System:

    \image qtcreator-preferences-environment-system.webp {System tab in Environment preferences}

    \list
        \li In the \uicontrol {When files are externally modified} field,
            select whether you want to be prompted to reload open files
            that were modified externally. For example, when you pull
            changes from a version control system.
        \li Select the \uicontrol {Auto-save modified files} check box to
            automatically save changed files at the intervals specified in
            the \uicontrol Interval field.
        \li Select the \uicontrol {Auto-save files after refactoring} check
            box to automatically save refactored files.
        \li Select the \uicontrol {Auto-suspend unmodified files} check
            box to automatically free the resources of open files after
            prolonged inactivity. The files are still listed in the
            \uicontrol {Open Documents} view. Set the minimum number of files
            that should be kept in memory in the \uicontrol {Files to keep open}
            field.
        \li Select the \uicontrol {Warn before opening text files greater than}
            check box to receive warnings about opening big text files.
        \li In the \uicontrol {Maximum number of entries in "Recent Files"}
            field, set the number of recently opened files listed in
            \uicontrol File > \uicontrol {Recent Files}.
    \endlist

    \sa {Apply quick fixes}, {Assign keyboard shortcuts}, {Rename symbols}

    \if defined(qtcreator)
    \sa {Find symbols}
    \endif
*/
