diff --git a/doc/qtcreator/images/qtcreator-remove-file.webp b/doc/qtcreator/images/qtcreator-remove-file.webp new file mode 100644 index 00000000000..a96ffacad7c Binary files /dev/null and b/doc/qtcreator/images/qtcreator-remove-file.webp differ diff --git a/doc/qtcreator/src/cmake/creator-projects-cmake.qdoc b/doc/qtcreator/src/cmake/creator-projects-cmake.qdoc index d9809f09a38..546b089898e 100644 --- a/doc/qtcreator/src/cmake/creator-projects-cmake.qdoc +++ b/doc/qtcreator/src/cmake/creator-projects-cmake.qdoc @@ -183,7 +183,7 @@ \section1 Managing Files - When you use project wizard templates to \l{Creating Files}{add files} to + When you use project wizard templates to \l{Create files}{add files} to a project, \QC automatically adds them to the \c {qt_add_executable()}, \c {add_executable()}, or \c {qt_add_library()} function in the CMakeLists.txt file. diff --git a/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc b/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc index 3d8d84882d9..9e81194b821 100644 --- a/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc +++ b/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc @@ -62,6 +62,10 @@ \list \li \l {Add a license header template for C++ code} \li \l {Add subprojects to projects} + \li \l {Create C++ classes} + \li \l {Create files} + \li \l {Create OpenGL fragment and vertex shaders} + \li \l {Create resource files} \li \l {Develop Qt for Python applications} \li \l {Specify project contents} \li \l {Select the build system} diff --git a/doc/qtcreator/src/projects/creator-only/creator-files-creating.qdoc b/doc/qtcreator/src/projects/creator-only/creator-files-creating.qdoc index 11319133271..2b730ee67e3 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-files-creating.qdoc +++ b/doc/qtcreator/src/projects/creator-only/creator-files-creating.qdoc @@ -2,121 +2,207 @@ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only /*! - \previouspage creator-project-creating.html \page creator-file-creating.html - \nextpage creator-project-opening.html + \previouspage creator-how-tos.html - \title Creating Files + \ingroup creator-how-to-projects + + \title Create files + + Use wizard templates to add individual files to your \l{Creating Projects} + {projects}. + + To add files to projects, select \uicontrol File > \uicontrol {New File}, and + then select the type of the file. \image qtcreator-new-file.webp {New File wizard} - Use wizard templates to add individual files to your \l{Creating Projects} - {projects}. Select \uicontrol File > \uicontrol {New File} and - select the type of the file: + \section1 Select file type - \list - \li \uicontrol {C/C++}: header and source files for new classes. - \li \uicontrol {Modeling}: State Chart XML (SCXML) files, - Universal Modeling Language (UML) style \l {Modeling}{models}, - and scratch models that use a temporary file. - \li \uicontrol {Qt}: source and header files for item, table, + The following table lists the types of wizard templates that you can use + for creating files. The \uicontrol {New File} dialog shows detailed information about each file + wizard template. + + \table + \header + \li Category + \li Purpose + \row + \li \uicontrol {C/C++} + \li Header and source files for new classes. + \row + \li \uicontrol {Modeling} + \li State Chart XML (SCXML) files, Universal Modeling Language (UML) + style \l {Modeling}{models}, and scratch models that use a temporary + file. + \row + \li \uicontrol {Qt} + \li Source and header files for item, table, or list models, \QD forms and a matching classes for Qt Widgets projects, Qt resource files, as well as QML and JavaScript files for Qt Quick projects. - \li \uicontrol {GLSL}: fragment and vertex shaders. - \li \uicontrol {General}: markdown files, empty files that you can save - with any filename extension, and scratch buffers that use temporary - files. - \li \uicontrol {Java}: class files. - \li \uicontrol {Python}: class and script files for Python projects. - \li \uicontrol {vcpkg} (experimental): \l {Managing Packages with vcpkg} - {vcpkg package manager} manifest files (vcpkg.json). - \li \uicontrol {Nim} (experimental): empty Nim source and script files. + \row + \li \uicontrol {GLSL} + \li OpenGL fragment and vertex shaders. + \row + \li \uicontrol {General} + \li Markdown files, empty files that you can save with any filename + extension, and scratch buffers that use temporary files. + \row + \li \uicontrol {Java} + \li Class files. + \row + \li \uicontrol {Python} + \li Class and script files for Python projects. + \row + \li \uicontrol {vcpkg} (experimental) + \li \l {Managing Packages with vcpkg}{vcpkg package manager} manifest + files (vcpkg.json). + \row + \li \uicontrol {Nim} (experimental) + \li Empty Nim source and script files. + \endtable + + \sa {Create C++ classes}, {Create OpenGL fragment and vertex shaders}, + {Create resource files}, {Use project wizards} +*/ + +/*! + \page creator-how-to-create-cpp-classes.html + \previouspage creator-how-tos.html + + \ingroup creator-how-to-projects + + \title Create C++ classes + + To create a C++ header and source file for a new class that you can add to a + C++ project: + + \list 1 + \li Select \uicontrol File > \uicontrol {New File} > + \uicontrol {C++ Class Wizard} > \uicontrol Choose. + \li Specify the class name, base class, and header and source files for + the class. + \image qtcreator-cpp-class-wizard.png {Enter Class Name dialog} \endlist - The \uicontrol {New File} dialog shows detailed information about each file - wizard template. - - \section1 C++ Classes - - The \uicontrol {C++ Class Wizard} allows you to create a C++ header and source - file for a new class that you can add to a C++ project. Specify the class - name, base class, and header and source files for the class. - The wizard supports namespaces. To use a namespace, enter a qualified class name in the \uicontrol {Class name} field. For example: \c MyNamespace::MySubNamespace::MyClass. The wizard suggests existing namespaces and class names as you type. - \image qtcreator-cpp-class-wizard.png "Enter Class Name dialog" + You can also create your own project and class wizards. + + \section1 Set file naming preferences The names of the header and source file are based on the class name. To - change the default suffix of a file, select \uicontrol Edit > \uicontrol Preferences > - \uicontrol {C++} > \uicontrol {File Naming}. + change the default suffix of a file, select \uicontrol Edit > + \uicontrol Preferences > \uicontrol {C++} > \uicontrol {File Naming}. \image qtcreator-options-cpp-files.png "C++ File Naming preferences" - In the \uicontrol {License template} field, you can use + In the \uicontrol {License template} field, enter \l{Using Variables in Wizards}{predefined wizard variables} to specify the path and filename of the license to use in the source and header files. - You can create your own project and class wizards. For more information, - see \l{Adding New Custom Wizards}. + \sa {Create files}, {Use project wizards}, {Adding New Custom Wizards} +*/ - \section1 Resource Files +/*! + \page creator-how-to-create-resource-files.html + \previouspage creator-how-tos.html - \QC supports the \l{The Qt Resource System}{Qt Resource System}, which is a - platform-independent mechanism for storing files in the application's - executable. + \ingroup creator-how-to-projects - \image qtcreator-add-resource-wizard.png "New File dialog" + \title Create resource files - The wizard creates a resource collection file (.qrc) that you can manage in - the resource editor. + The \l{The Qt Resource System}{Qt Resource System} is a platform-independent + mechanism for storing files in the application's executable. - \image qtcreator-add-resource.png "Editing resource files" + To create a resource file: - Select \uicontrol {Add Files} to locate and add individual - files. + \list 1 + \li Select \uicontrol File > \uicontrol {New File} > \uicontrol {Qt} > + \uicontrol {Qt Resource File} > \uicontrol Choose. + \image qtcreator-add-resource-wizard.png {New File dialog} + \li Follow the instructions of the wizard to create a resource + collection file (.qrc). + \li Open the resource file in the resource editor. + \image qtcreator-add-resource.png "Editing resource files" + \li Select \uicontrol {Add Files} to locate and add individual files. + \endlist + + \section1 Sort resource files To list the folders and files in ascending alphabetic order in the source tree, select \uicontrol {Sort Alphabetically} in the context menu. - By default, resources are accessible in the application under the same file + \section1 Set a path prefix + + By default, resources in the application are accessible under the same file name as they have in the source tree, with a \c{:/} prefix, or by a URL with a \c qrc scheme. To specify a path prefix for all files in the \c .qrc file, select \uicontrol {Add Prefix} and enter the prefix in the \uicontrol Prefix field. + \section1 Set a locale + Some resources need to change based on the user's locale, such as translation files or icons. You can specify a locale in the \uicontrol Language field. + Use a lowercase, two-letter \l {https://www.iso.org/iso-639-language-codes.html} + {ISO 639 language code}, such as \e de, \e en, or \e fr. + + \section1 Remove resource files + Select \uicontrol Remove to remove the selected file from the resource - collection. In the \uicontrol {Remove File} dialog, select the + collection. + + In the \uicontrol {Remove File} dialog, select the \uicontrol {Delete file permanently} check box to remove the file from - the file system. To remove files that cannot be found in the file system, + the file system. + + \image qtcreator-remove-file.webp {Remove File dialog} + + To remove files that cannot be found in the file system, select \uicontrol {Remove Missing Files}. The above functions are also available in the context menu in the - \uicontrol Projects view. + \l Projects view. - \section1 OpenGL Fragment and Vertex Shaders + \sa {Create files}, {Use project wizards}, {QLocale} +*/ - Qt supports integration with OpenGL implementations on all - platforms, which allows you to display hardware accelerated 3D graphics - alongside a more conventional user interface. For more information, see - \l{Qt GUI}. +/*! + \page creator-how-to-create-opengl-shaders.html + \previouspage creator-how-tos.html + + \ingroup creator-how-to-projects + + \title Create OpenGL fragment and vertex shaders + + Qt supports integration with OpenGL implementations on all platforms, so you + can display hardware accelerated 3D graphics alongside a more conventional + user interface. For more information, see \l{Qt GUI}. You can use the QOpenGLShader class to compile OpenGL shaders written in the OpenGL Shading Language (GLSL) and in the OpenGL/ES Shading Language (GLSL/ES). QOpenGLShader and QOpenGLShaderProgram shelter you from the - details of - compiling and linking vertex and fragment shaders. + details of compiling and linking vertex and fragment shaders. - You can use \QC code editor to write fragment and vertex shaders - in GLSL or GLSL/ES. The code editor offers syntax highlighting and code - completion for the files. + To create OpenGL shaders: - \image qtcreator-new-opengl-file.png "New OpenGL file wizard" + \list 1 + \li Select \uicontrol File > \uicontrol {New File} > \uicontrol {GLSL}. + \image qtcreator-new-opengl-file.png {New OpenGL file wizard} + \li Select the type of the shader to create, and then select + \uicontrol Choose. + \li Follow the instructions of the wizard to create the shader file. + \li Open the shader file in the code editor, and write the shader code + in GLSL or GLSL/ES. The code editor offers syntax highlighting and + code completion for the files. + \endlist + + \sa {Create files}, {Use project wizards} */ diff --git a/doc/qtcreator/src/projects/creator-only/creator-projects-creating.qdoc b/doc/qtcreator/src/projects/creator-only/creator-projects-creating.qdoc index c48a2ead78f..39c78dd197b 100644 --- a/doc/qtcreator/src/projects/creator-only/creator-projects-creating.qdoc +++ b/doc/qtcreator/src/projects/creator-only/creator-projects-creating.qdoc @@ -69,7 +69,7 @@ install and configure some additional software on the devices to be able to \l{Connecting Devices}{connect} to them from the development PC. - \sa {Manage Projects}{How-to: Manage Projects}, {Creating Files}, + \sa {Manage Projects}{How-to: Manage Projects}, {Adding Libraries to Projects}, {Opening Projects}, {Adding New Custom Wizards} */ @@ -172,7 +172,7 @@ \uicontrol Wizard. All wizard actions start with \uicontrol Impl there. \sa {Assign keyboard shortcuts}, {Activating Kits for a Project}, - {Creating Files}, {Creating Projects} + {Create files}, {Creating Projects} */ /*! diff --git a/doc/qtcreator/src/qtcreator-toc.qdoc b/doc/qtcreator/src/qtcreator-toc.qdoc index 2fa2298a6b6..08e8ee82128 100644 --- a/doc/qtcreator/src/qtcreator-toc.qdoc +++ b/doc/qtcreator/src/qtcreator-toc.qdoc @@ -25,7 +25,6 @@ \list \li \l{Creating Projects} \list - \li \l{Creating Files} \li \l{Opening Projects} \li \l{Adding Libraries to Projects} \li \l{Adding New Custom Wizards} @@ -278,6 +277,10 @@ \list \li \l {Add a license header template for C++ code} \li \l {Add subprojects to projects} + \li \l {Create C++ classes} + \li \l {Create files} + \li \l {Create OpenGL fragment and vertex shaders} + \li \l {Create resource files} \li \l {Develop Qt for Python applications} \li \l {Select the build system} \li \l {Specify project contents} diff --git a/doc/qtcreator/src/qtquick/creator-only/qtquick-creating.qdoc b/doc/qtcreator/src/qtquick/creator-only/qtquick-creating.qdoc index 4a3746f4c29..3188f73d200 100644 --- a/doc/qtcreator/src/qtquick/creator-only/qtquick-creating.qdoc +++ b/doc/qtcreator/src/qtquick/creator-only/qtquick-creating.qdoc @@ -33,7 +33,7 @@ \QC creates the necessary boilerplate files. Some of the files are specific to a particular target platform. You can use wizard templates - also to \l{Creating Files}{add files} to the projects. + also to \l{Create files}{add files} to the projects. \section1 Qt Quick Applications diff --git a/doc/qtcreator/src/user-interface/creator-file-system-view.qdoc b/doc/qtcreator/src/user-interface/creator-file-system-view.qdoc index b2a9f0dfe1d..e8d4eeb97e5 100644 --- a/doc/qtcreator/src/user-interface/creator-file-system-view.qdoc +++ b/doc/qtcreator/src/user-interface/creator-file-system-view.qdoc @@ -77,7 +77,7 @@ \if defined(qtdesignstudio) \l{Adding Files to Projects}. \else - \l{Creating Files}. + \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 diff --git a/doc/qtcreator/src/user-interface/creator-projects-view.qdoc b/doc/qtcreator/src/user-interface/creator-projects-view.qdoc index 9d632a127e6..905c4ebe779 100644 --- a/doc/qtcreator/src/user-interface/creator-projects-view.qdoc +++ b/doc/qtcreator/src/user-interface/creator-projects-view.qdoc @@ -73,7 +73,7 @@ \if defined(qtdesignstudio) \l{Adding Files to Projects}. \else - \l{Creating Files}. + \l{Create files}. \endif \li Rename existing files. If you change the base name of a file, \QC displays a list of other files with the same base name