aboutsummaryrefslogtreecommitdiffstats
path: root/doc/qtcreator/src/user-interface/creator-file-system-view.qdoc
blob: 24f3b38479cd11132d424f6541d45ab3983cb01c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
// Copyright (C) 2023 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
    \page creator-file-system-view.html
    \if defined(qtdesignstudio)
    \previouspage creator-projects-view.html
    \nextpage creator-open-documents-view.html
    \else
    \previouspage creator-reference.html
    \endif

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

    \title File System

    \brief Shows all the files in the current directory.

    \if defined(qtcreator)
    \note Usually, \l{Navigate with locator}{searching with the locator}
    is the fastest way to find a particular project, file, class, or function,
    or almost anything else in your project. Use the \e {file system (f)} filter
    to open files from anywhere in the file system.

    \image qtcreator-filesystem-view.webp {File System view in the sidebar}
    \else
    \image qtcreator-filesystem-view-design.png {File System view}
    \endif

    To move to the root directory of the file system, select \uicontrol Computer
    in the menu (1). Select \uicontrol Home to move to the user's home
    directory. Further, you can select a project to move to an open project
    or \uicontrol Projects to move to the directory specified in the
    \uicontrol {Projects directory} field in \preferences >
    \uicontrol {Build & Run} > \uicontrol General.

    The file that is currently active in the editor determines which folder
    to display in the \uicontrol {File System} view:

    \list
        \li \uicontrol Projects if the file is located in a subdirectory of the
            \uicontrol {Projects directory}
        \li \uicontrol Home if the file is located in the user's home directory
        \li \uicontrol Computer in all other cases
    \endlist

    To stop the synchronization between the editor and the
    \uicontrol {File System} view, deselect the \inlineimage icons/linkicon.png
    (\uicontrol {Synchronize Root Directory with Editor}) button.

    The view displays the path to the active file as bread crumbs. You can move
    to any directory along the path by clicking it.

    \section1 File System Context Menu

    Use the context menu functions to:

    \list
        \li Open files with the default editor or some other editor.
        \li Open a project located in the selected directory.
        \li Show the file or directory in the file explorer.
        \li Open a terminal window in the selected directory or in the directory
            that has the file. To specify the terminal to use on Linux and
            \macos, select \preferences > \uicontrol Environment >
            \uicontrol System.
            \if defined(qtcreator)
            To use an \l{Terminal} {internal terminal}, select \preferences >
            \uicontrol Terminal > \uicontrol {Use internal terminal}.
            \endif
        \li Search in the selected directory.
        \li View file properties, such as name, path, MIME type, default editor,
            line endings, indentation, owner, size, last read and modified
            dates, and permissions.
        \li Create new files. For more information, see
            \if defined(qtdesignstudio)
            \l{Adding Files to Projects}.
            \else
            \l{Create files}.
            \endif
        \li Rename existing files. To move the file to another directory, enter
            the relative or absolute path to its new location in addition to the
            new filename.
        \li Remove existing files.
        \li Create new folders.
        \if defined(qtcreator)
        \li Compare the selected file with the currently open file in the diff
            editor. For more information, see \l{Compare files}.
        \endif
        \li Display the contents of a particular directory in the view.
        \li Collapse all open folders.
    \endlist

    \if defined(qtcreator)
    \section1 File System View Toolbar

    The toolbar in the \uicontrol {File System} view has additional
    options.

    To manage view contents, select \inlineimage icons/filtericon.png
    (\uicontrol Options):

    \list
        \li To hide the bread crumbs, deselect the
            \uicontrol {Show Bread Crumbs} check box.
        \li By default, the view separates folders from files and lists them
            first. To list all items in alphabetic order, deselect the
            \uicontrol {Show Folders on Top} check box.
        \li To also show hidden files, select \uicontrol {Show Hidden Files}.
    \endlist

    To stop the synchronization with the file currently open in the
    editor, deselect \inlineimage icons/linkicon.png
    (\uicontrol {Synchronize with Editor}).

    \sa {View CMake project contents}, {Projects}
    \endif
*/