Doc: Update widget-based app tutorial

Task-number: QTCREATORBUG-23364
Change-Id: Iedc02d8e774093d176e6ccd881f096d9b3163a60
Reviewed-by: Christian Kandeler <christian.kandeler@qt.io>
This commit is contained in:
Leena Miettinen
2020-04-14 11:50:21 +02:00
parent b85ed5fa67
commit fc879d196f
17 changed files with 38 additions and 27 deletions

View File

@@ -1,2 +1,10 @@
These forms are processed at run-time to produce dynamically-generated user interfaces. In order to generate a form at run-time, a resource file containing a .ui file is needed. Applications that use the form handling classes need to be configured to be built against the QtUiTools module. This is done by including the following declaration in a qmake project file to ensure that the application is compiled and linked appropriately. A form loader object, provided by the QUiLoader class, is used to construct the user interface. This user interface IDE Overview
can be retrieved from any QIODevice; for example, a QFile object can be used to obtain a form stored in a project's resources. The QUiLoader::load() function takes the user interface description contained in the file and constructs the form widget.
Qt Creator is an integrated development environment (IDE) that provides you
with tools to design and develop applications with the Qt application framework.
Qt is designed for developing applications and user interfaces once and
deploying them to several desktop, embedded, and mobile operating systems or web
browsers (experimental). Qt Creator provides you with tools for accomplishing
your tasks throughout the whole application development life-cycle, from
creating a project to deploying the application to the target platforms.

Binary file not shown.

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 25 KiB

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.5 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 47 KiB

After

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 22 KiB

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 56 KiB

After

Width:  |  Height:  |  Size: 17 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.5 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 4.3 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 8.1 KiB

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.2 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.9 KiB

After

Width:  |  Height:  |  Size: 4.5 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 11 KiB

After

Width:  |  Height:  |  Size: 8.2 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.4 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.8 KiB

After

Width:  |  Height:  |  Size: 8.2 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.2 KiB

After

Width:  |  Height:  |  Size: 9.0 KiB

View File

@@ -49,7 +49,7 @@
\list 1 \list 1
\li Select \uicontrol File > \uicontrol {New File or Project} > \li Select \uicontrol File > \uicontrol {New File or Project} >
\uicontrol Application > \uicontrol {Qt Widgets Application} > \uicontrol Application (Qt) > \uicontrol {Qt Widgets Application} >
\uicontrol Choose. \uicontrol Choose.
\image qtcreator-new-qt-gui-application.png "New File or Project dialog" \image qtcreator-new-qt-gui-application.png "New File or Project dialog"
@@ -61,20 +61,16 @@
\li In the \uicontrol{Name} field, type \b {TextFinder}. \li In the \uicontrol{Name} field, type \b {TextFinder}.
\li In the \uicontrol {Create in} field, enter the path for the project files. \li In the \uicontrol {Create in} field, enter the path for the project files.
For example, \c {C:\Qt\examples}, and then click \uicontrol{Next} (on For example, \c {C:\Qt\examples}, and then select \uicontrol{Next} (on
Windows and Linux) or \uicontrol Continue (on \macos). Windows and Linux) or \uicontrol Continue (on \macos).
The \uicontrol {Kit Selection} dialog opens. The \uicontrol {Define Build System} dialog opens.
\image qtcreator-new-project-qt-versions-qt-gui.png "Kit Selection dialog" \image qtcreator-new-project-build-system-qt-gui.png "Define Build System dialog"
\li Select build and run \l{glossary-buildandrun-kit}{kits} for your project, \li In the \uicontrol {Build system} field, select the build system to
and click \uicontrol Next or \uicontrol Continue. use for building and running the project: \l qmake,
\l {Setting Up CMake}{CMake}, or \l {Setting Up Qbs}{Qbs}.
\note If only one kit is specified in \uicontrol Tools >
\uicontrol Options > \uicontrol Kits (on Windows and Linux) or in
\uicontrol {\QC} > \uicontrol Preferences > \uicontrol Kits
(on \macos), this dialog is skipped.
The \uicontrol{Class Information} dialog opens. The \uicontrol{Class Information} dialog opens.
@@ -89,13 +85,20 @@
\note The \uicontrol{Header file}, \uicontrol{Source file} and \uicontrol{Form file} \note The \uicontrol{Header file}, \uicontrol{Source file} and \uicontrol{Form file}
fields are automatically updated to match the name of the class. fields are automatically updated to match the name of the class.
\li Click \uicontrol Next or \uicontrol Continue. The \uicontrol {Kit Selection} dialog opens.
\image qtcreator-new-project-qt-versions-qt-gui.png "Kit Selection dialog"
\li Select build and run \l{glossary-buildandrun-kit}{kits} for your project,
and select \uicontrol Next or \uicontrol Continue.
\li Select \uicontrol Next or \uicontrol Continue.
The \uicontrol{Project Management} dialog opens. The \uicontrol{Project Management} dialog opens.
\image qtcreator-new-project-summary-qt-gui.png "Project Management dialog" \image qtcreator-new-project-summary-qt-gui.png "Project Management dialog"
\li Review the project settings, and click \uicontrol{Finish} (on Windows and \li Review the project settings, and select \uicontrol{Finish} (on Windows and
Linux) or \uicontrol Done (on \macos) to create the project. Linux) or \uicontrol Done (on \macos) to create the project.
\endlist \endlist
@@ -107,9 +110,9 @@
\list \list
\li main.cpp
\li textfinder.h \li textfinder.h
\li textfinder.cpp \li textfinder.cpp
\li main.cpp
\li textfinder.ui \li textfinder.ui
\li textfinder.pro \li textfinder.pro
@@ -150,7 +153,7 @@
\uicontrol Sidebar. For example, to find the \uicontrol Label widget, start typing \uicontrol Sidebar. For example, to find the \uicontrol Label widget, start typing
the word \b label. the word \b label.
\image qtcreator-texfinder-filter.png "Filter field" \image qtcreator-textfinder-filter.png "Filter field"
\li Double-click the \uicontrol{Label} widget and enter the text \li Double-click the \uicontrol{Label} widget and enter the text
\b{Keyword}. \b{Keyword}.
@@ -164,23 +167,23 @@
\image qtcreator-textfinder-objectname.png "Changing object names" \image qtcreator-textfinder-objectname.png "Changing object names"
\li Press \key {Ctrl+A} (or \key {Cmd+A}) to select the widgets and \li Press \key {Ctrl+A} (or \key {Cmd+A}) to select the widgets and
click \uicontrol{Lay out Horizontally} (or press \uicontrol{Ctrl+H} on Linux or select \uicontrol{Lay out Horizontally} (or press \key {Ctrl+H} on Linux or
Windows or \key {Ctrl+Shift+H} on \macos) to apply a horizontal Windows or \key {Ctrl+Shift+H} on \macos) to apply a horizontal
layout (QHBoxLayout). layout (QHBoxLayout).
\image qtcreator-texfinder-ui-horizontal-layout.png "Applying horizontal layout" \image qtcreator-textfinder-ui-horizontal-layout.png "Applying horizontal layout"
\li Drag and drop a \uicontrol{Text Edit} widget (QTextEdit) to the form. \li Drag and drop a \uicontrol{Text Edit} widget (QTextEdit) to the form.
\li Select the screen area and click \uicontrol{Lay out Vertically} (or press \li Select the screen area, and then select \uicontrol{Lay out Vertically}
\uicontrol{Ctrl+L}) to apply a vertical layout (QVBoxLayout). (or press \key {Ctrl+L}) to apply a vertical layout (QVBoxLayout).
\image qtcreator-textfinder-ui.png "Text Finder UI" \image qtcreator-textfinder-ui.png "Text Finder UI"
Applying the horizontal and vertical layouts ensures that the Applying the horizontal and vertical layouts ensures that the
application UI scales to different screen sizes. application UI scales to different screen sizes.
\li To call a find function when users press the \uicontrol Find button, you \li To call a find function when users select the \uicontrol Find button, you
use the Qt signals and slots mechanism. A signal is emitted when a use the Qt signals and slots mechanism. A signal is emitted when a
particular event occurs and a slot is a function that is called in particular event occurs and a slot is a function that is called in
response to a particular signal. Qt widgets have predefined signals response to a particular signal. Qt widgets have predefined signals
@@ -201,7 +204,7 @@
\endlist \endlist
\li Press \uicontrol{Ctrl+S} (or \key {Cmd+S}) to save your changes. \li Press \key {Ctrl+S} (or \key {Cmd+S}) to save your changes.
\endlist \endlist
@@ -295,7 +298,7 @@
\li In the \uicontrol{Name} field, enter \b{textfinder}. \li In the \uicontrol{Name} field, enter \b{textfinder}.
\li In the \uicontrol{Path} field, enter \c{C:\Qt\examples\TextFinder}, \li In the \uicontrol{Path} field, enter \c{C:\Qt\examples\TextFinder},
and click \uicontrol Next or \uicontrol Continue. and select \uicontrol Next or \uicontrol Continue.
The \uicontrol{Project Management} dialog opens. The \uicontrol{Project Management} dialog opens.
@@ -303,8 +306,8 @@
\li In the \uicontrol{Add to project} field, select \b{TextFinder.pro} \li In the \uicontrol{Add to project} field, select \b{TextFinder.pro}
and click \uicontrol{Finish} or \uicontrol Done to open the file in the code and select \uicontrol{Finish} or \uicontrol Done to open the file
editor. in the code editor.
\li Select \uicontrol Add > \uicontrol {Add Prefix}. \li Select \uicontrol Add > \uicontrol {Add Prefix}.
@@ -320,7 +323,7 @@
\section1 Compiling and Running Your Program \section1 Compiling and Running Your Program
Now that you have all the necessary files, click the Now that you have all the necessary files, select the
\inlineimage run_small.png \inlineimage run_small.png
button to compile and run your program. button to compile and run your program.