Merge remote-tracking branch 'origin/qds-1.50' into qds-1.59

Change-Id: If4869664ad4cbb5ec56e7c306f47d0bf0f1f075c
This commit is contained in:
Tim Jenssen
2020-05-27 19:02:07 +02:00
168 changed files with 1025 additions and 655 deletions

View File

@@ -1,9 +1,9 @@
#BINARY_ARTIFACTS_BRANCH = master #BINARY_ARTIFACTS_BRANCH = master
#PROJECT_USER_FILE_EXTENSION = .user #PROJECT_USER_FILE_EXTENSION = .user
set(IDE_VERSION "4.12.1") # The IDE version. set(IDE_VERSION "4.12.2") # The IDE version.
set(IDE_VERSION_COMPAT "4.12.0") # The IDE Compatibility version. set(IDE_VERSION_COMPAT "4.12.0") # The IDE Compatibility version.
set(IDE_VERSION_DISPLAY "4.12.1") # The IDE display version. set(IDE_VERSION_DISPLAY "4.12.2") # The IDE display version.
set(IDE_COPYRIGHT_YEAR "2020") # The IDE current copyright year. set(IDE_COPYRIGHT_YEAR "2020") # The IDE current copyright year.
set(IDE_SETTINGSVARIANT "QtProject") # The IDE settings variation. set(IDE_SETTINGSVARIANT "QtProject") # The IDE settings variation.

View File

@@ -14,6 +14,7 @@ General
------- -------
* Fixed crash when changing font settings (QTCREATORBUG-14385) * Fixed crash when changing font settings (QTCREATORBUG-14385)
* Fixed availability of `Link with Qt` information on startup (QTCREATORBUG-23900)
Editing Editing
------- -------
@@ -39,6 +40,10 @@ Projects
* Fixed issue with JOM (QTCREATORBUG-22645) * Fixed issue with JOM (QTCREATORBUG-22645)
### Qbs
* Fixed crash when updating project (QTCREATORBUG-23924)
### Compilation Database ### Compilation Database
* Fixed issues with symbolic links (QTCREATORBUG-23511) * Fixed issues with symbolic links (QTCREATORBUG-23511)
@@ -46,8 +51,13 @@ Projects
Debugging Debugging
--------- ---------
* Fixed startup when Python's JSON module is missing (QTCREATORBUG-24004)
* Fixed pretty printing of `std::unique_ptr` with custom deleter (QTCREATORBUG-23885) * Fixed pretty printing of `std::unique_ptr` with custom deleter (QTCREATORBUG-23885)
### GDB
* Fixed handling of register addresses with lowercase characters
* Fixed issue with GDB reporting zero array size in some cases (QTCREATORBUG-23998)
Qt Quick Designer Qt Quick Designer
----------------- -----------------
@@ -67,10 +77,39 @@ Platforms
* Fixed crash at startup when Qt is missing in Kit (QTCREATORBUG-23963) * Fixed crash at startup when Qt is missing in Kit (QTCREATORBUG-23963)
* Fixed `Always use this device for this project` (QTCREATORBUG-23918) * Fixed `Always use this device for this project` (QTCREATORBUG-23918)
* Fixed issue with "side by side" NDK installation (QTCREATORBUG-23903)
### OpenBSD ### OpenBSD
* Fixed Qt ABI detection (QTCREATORBUG-23818) * Fixed Qt ABI detection (QTCREATORBUG-23818)
### MCU
* Fixed various issues with Kit creation and cleanup
Credits for these changes go to: Credits for these changes go to:
-------------------------------- --------------------------------
Alessandro Portale
André Pönitz
Assam Boudjelthia
Brook Cronin
Christian Kandeler
Christian Stenger
Cristian Adam
David Schulz
Eike Ziller
Friedemann Kleint
Henning Gruendl
Jeremy Ephron
Johanna Vanhatapio
Leander Schulten
Leena Miettinen
Nikolai Kosjar
Robert Löhning
Sebastian Verling
Sergey Belyashov
Thiago Macieira
Thomas Hartmann
Tim Jenssen
Venugopal Shivashankar
Vikas Pachdha

View File

@@ -17,6 +17,9 @@ macro.note = "\\b{Note:}"
macro.oslash.HTML = "ø" macro.oslash.HTML = "ø"
macro.ouml.HTML = "ö" macro.ouml.HTML = "ö"
macro.QA = "Qt Assistant" macro.QA = "Qt Assistant"
macro.QB = "Qt Bridge"
macro.QBPS = "Qt Bridge for Adobe Photoshop"
macro.QBSK = "Qt Bridge for Sketch"
macro.QC = "$IDE_DISPLAY_NAME" macro.QC = "$IDE_DISPLAY_NAME"
macro.QCE = "$IDE_DISPLAY_NAME Enterprise" macro.QCE = "$IDE_DISPLAY_NAME Enterprise"
macro.QD = "Qt Designer" macro.QD = "Qt Designer"

Binary file not shown.

Before

Width:  |  Height:  |  Size: 16 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 7.8 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.7 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.7 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 6.2 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 4.5 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.3 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.3 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.0 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.6 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.2 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.6 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.2 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.9 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.3 KiB

After

Width:  |  Height:  |  Size: 4.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 62 KiB

After

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 29 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 38 KiB

After

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 79 KiB

After

Width:  |  Height:  |  Size: 53 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 25 KiB

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 60 KiB

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 5.0 KiB

After

Width:  |  Height:  |  Size: 6.2 KiB

View File

@@ -460,7 +460,7 @@
\list 1 \list 1
\li Perf events may be globally disabled on your system. The \li Perf events may be globally disabled on your system. The
preconfigured Boot to Qt images come with perf events enabled. For preconfigured Boot2Qt images come with perf events enabled. For
a custom configuration you need to make sure that the file a custom configuration you need to make sure that the file
\c {/proc/sys/kernel/perf_event_paranoid} contains a value smaller \c {/proc/sys/kernel/perf_event_paranoid} contains a value smaller
than \c {2}. For maximum flexibility in recording traces you can than \c {2}. For maximum flexibility in recording traces you can

View File

@@ -32,7 +32,7 @@
/*! /*!
//! [cmake deploying embedded] //! [cmake deploying embedded]
\section1 Deploying CMake Projects to Embedded Linux Devices \section1 Deploying CMake Projects to Generic Remote Linux Devices
\QC cannot directly extract files to be installed from a CMake project. \QC cannot directly extract files to be installed from a CMake project.
Therefore, a special deploy step is created that installs the project into Therefore, a special deploy step is created that installs the project into

View File

@@ -158,6 +158,6 @@
\li \l {Opening Projects} \li \l {Opening Projects}
\li \l {Specifying Build Settings} \li \l {Specifying Build Settings}
\li \l {Specifying Run Settings} \li \l {Specifying Run Settings}
\li \l {Deploying CMake Projects to Embedded Linux Devices} \li \l {Deploying CMake Projects to Generic Remote Linux Devices}
\endlist \endlist
*/ */

View File

@@ -41,7 +41,7 @@
\title Coding \title Coding
\if defined(qtcreator) \if defined(qtcreator)
\image creator_coding.png \image front-coding.png
\endif \endif
\list \list

View File

@@ -38,11 +38,11 @@
\nextpage creator-deployment-qnx.html \nextpage creator-deployment-qnx.html
\endif \endif
\title Deploying Applications to Embedded Linux Devices \title Deploying Applications to Generic Remote Linux Devices
You can specify settings for deploying applications to generic Linux devices You can specify settings for deploying applications to generic remote
in the project .pro file. You can view the settings in the Linux devices in the project .pro file. You can view the settings in
\uicontrol Projects mode, in \uicontrol {Run Settings}. the \uicontrol Projects mode, in \uicontrol {Run Settings}.
\image qtcreator-embedded-linux-deployment-overview.png "Deploy to device" \image qtcreator-embedded-linux-deployment-overview.png "Deploy to device"

View File

@@ -26,14 +26,14 @@
/*! /*!
//! [running on embedded linux] //! [running on embedded linux]
\section1 Running on Embedded Linux Devices \section1 Running on Generic Remote Linux Devices
To build the application and run it on a device: To build the application and run it on a device:
\list 1 \list 1
\li Specify a connection to the device. For more information, see \li Specify a connection to the device. For more information, see
\l{Connecting Embedded Linux Devices}. \l{Connecting Generic Remote Linux Devices}.
\li Click the \uicontrol Run button. \li Click the \uicontrol Run button.

View File

@@ -1,6 +1,6 @@
/**************************************************************************** /****************************************************************************
** **
** Copyright (C) 2017 The Qt Company Ltd. ** Copyright (C) 2020 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/ ** Contact: https://www.qt.io/licensing/
** **
** This file is part of the Qt Creator documentation. ** This file is part of the Qt Creator documentation.
@@ -24,11 +24,11 @@
****************************************************************************/ ****************************************************************************/
/*! /*!
//! [run settings embedded] //! [run settings boot2qt]
\section1 Specifying Run Settings for Embedded Devices \section1 Specifying Run Settings for Boot2Qt Devices
To run and debug an application on an embedded device (commercial only), you To run and debug an application on a Boot2Qt device (commercial only), you
must create connections from the development host to the device and add the must create connections from the development host to the device and add the
device configurations to \l{glossary-buildandrun-kit}{kits}. Select device configurations to \l{glossary-buildandrun-kit}{kits}. Select
\uicontrol {Manage Kits} to add devices to kits. For more information, see \uicontrol {Manage Kits} to add devices to kits. For more information, see
@@ -41,7 +41,7 @@
host and on the device. host and on the device.
For more information on the deployment steps, see For more information on the deployment steps, see
\l{Deploying Applications to Embedded Linux Devices}. \l{Deploying Applications to Generic Remote Linux Devices}.
//! [run settings embedded] //! [run settings boot2qt]
*/ */

View File

@@ -33,7 +33,7 @@
host to the device and add the device configurations to host to the device and add the device configurations to
\l{glossary-buildandrun-kit}{kits}. Click \uicontrol {Manage Kits} to add devices \l{glossary-buildandrun-kit}{kits}. Click \uicontrol {Manage Kits} to add devices
to kits. For more information, see to kits. For more information, see
\l {Connecting Embedded Linux Devices}. \l {Connecting Generic Remote Linux Devices}.
When you run the application, \QC copies the files to the connected device. When you run the application, \QC copies the files to the connected device.

View File

@@ -1,6 +1,6 @@
/**************************************************************************** /****************************************************************************
** **
** Copyright (C) 2019 The Qt Company Ltd. ** Copyright (C) 2020 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/ ** Contact: https://www.qt.io/licensing/
** **
** This file is part of the Qt Creator documentation. ** This file is part of the Qt Creator documentation.
@@ -33,19 +33,20 @@
\nextpage creator-developing-ios.html \nextpage creator-developing-ios.html
\endif \endif
\title Connecting Embedded Linux Devices \title Connecting Generic Remote Linux Devices
You can connect embedded Linux devices to the development PC to run, You can connect generic Linux devices to the development PC to run,
debug, and analyze applications built for them from \QC. debug, and analyze applications built for them from \QC.
If you have a tool chain for building applications for embedded Linux If you have a tool chain for building applications for embedded Linux
devices installed on the development PC, you can add devices installed on the development PC, you can add
it to \QC. You can then select a \l{glossary-buildandrun-kit}{kit} it to \QC. You can then select a \l{glossary-buildandrun-kit}{kit}
with \uicontrol {Embedded Linux} device type to with \uicontrol {Embedded Linux} device type to
build applications for and run them on embedded Linux devices. build applications for and run them on the devices.
To be able to run and debug applications on embedded Linux devices, you must To be able to run and debug applications on generic remote Linux devices,
add devices and select them in the \QC \l{glossary-buildandrun-kit}{kit}. you must add devices and select them in the \QC \l{glossary-buildandrun-kit}
{kit}.
You use a wizard to create the connections. You can edit the settings later You use a wizard to create the connections. You can edit the settings later
in \uicontrol Tools > \uicontrol Options > \uicontrol Devices > in \uicontrol Tools > \uicontrol Options > \uicontrol Devices >
@@ -145,7 +146,7 @@
When you run the project, \QC deploys the application as specified by the When you run the project, \QC deploys the application as specified by the
deploy steps. By default, \QC copies the application files to the device. deploy steps. By default, \QC copies the application files to the device.
For more information, see \l{Deploying Applications to Embedded Linux Devices}. For more information, see \l{Deploying Applications to Generic Remote Linux Devices}.
\endlist \endlist

View File

@@ -36,7 +36,7 @@
\title Advanced Use \title Advanced Use
\image creator_advanceduse.png \image front-advanced.png
\QC attempts to meet your development needs, whether you are an \QC attempts to meet your development needs, whether you are an
experienced Qt developer or a newcomer to Qt. When you install \QC experienced Qt developer or a newcomer to Qt. When you install \QC

View File

@@ -49,7 +49,7 @@
When you deploy the application to an Android device, \QC copies When you deploy the application to an Android device, \QC copies
the application files to the device. In addition, you can determine the application files to the device. In addition, you can determine
the Qt libraries to use. the Qt libraries to use.
\li \l{Deploying Applications to Embedded Linux Devices} \li \l{Deploying Applications to Generic Remote Linux Devices}
When you deploy the application to a generic Linux-based device, \QC When you deploy the application to a generic Linux-based device, \QC
copies the application files to the connected device. You can test copies the application files to the connected device. You can test

View File

@@ -36,7 +36,7 @@
\title Designing User Interfaces \title Designing User Interfaces
\image creator_designinguserinterface.png \image front-ui.png
\QC provides integrated visual editors for designing Qt Quick and \QC provides integrated visual editors for designing Qt Quick and
widget-based applications in the Design mode. The integration widget-based applications in the Design mode. The integration

View File

@@ -38,9 +38,9 @@
\table \table
\row \row
\li \inlineimage creator_gettingstarted.png \li \inlineimage front-gs.png
\li \inlineimage creator_designinguserinterface.png \li \inlineimage front-ui.png
\li \inlineimage creator_advanceduse.png \li \inlineimage front-advanced.png
\row \row
\li \b {\l{IDE Overview}} \li \b {\l{IDE Overview}}
@@ -59,8 +59,8 @@
control systems. For an overview of the options you have, go to control systems. For an overview of the options you have, go to
\l{Configuring Qt Creator}. \l{Configuring Qt Creator}.
\row \row
\li \inlineimage creator_buildingrunning.png \li \inlineimage front-preview.png
\li \inlineimage creator_gettinghelp.png \li \inlineimage front-help.png
\li \li
\row \row
\li \b {\l{Building and Running an Example}} \li \b {\l{Building and Running an Example}}

View File

@@ -36,7 +36,7 @@
\title Getting Help \title Getting Help
\image creator_gettinghelp.png \image front-help.png
\list \list

View File

@@ -69,7 +69,7 @@
to debug applications on them with GDB or a hardware debugger. to debug applications on them with GDB or a hardware debugger.
\endif \endif
\li \l{Connecting Embedded Linux Devices} \li \l{Connecting Generic Remote Linux Devices}
If you have a tool chain for building applications for embedded If you have a tool chain for building applications for embedded
Linux devices installed on the development Linux devices installed on the development
@@ -114,7 +114,7 @@
You can use the experimental Qt Application Manager plugin You can use the experimental Qt Application Manager plugin
(commercial only) to deploy, run, and debug applications on the (commercial only) to deploy, run, and debug applications on the
local Linux PC, remote generic SSH Linux targets, or local Linux PC, remote generic SSH Linux targets, or
\l{Embedded Devices}{embedded devices}. \l{Boot2Qt Devices}{Boot2Qt devices}.
\endlist \endlist
\endif \endif
*/ */

View File

@@ -47,9 +47,9 @@
\table \table
\row \row
\li \inlineimage creator_managingprojects.png \li \inlineimage front-projects.png
\li \inlineimage creator_designinguserinterface.png \li \inlineimage front-ui.png
\li \inlineimage creator_coding.png \li \inlineimage front-coding.png
\row \row
\li \b {\l{Managing Projects}} \li \b {\l{Managing Projects}}
@@ -84,9 +84,9 @@
available that provides information about the code to IDEs. available that provides information about the code to IDEs.
For more information, see \l{Coding}. For more information, see \l{Coding}.
\row \row
\li \inlineimage creator_buildingrunning.png \li \inlineimage front-preview.png
\li \inlineimage creator_testing.png \li \inlineimage front-testing.png
\li \inlineimage creator_publishing.png \li \inlineimage front-publishing.png
\row \row
\li \b {\l{Building and Running}} \li \b {\l{Building and Running}}

View File

@@ -112,7 +112,7 @@
\endlist \endlist
\section2 Developing for Embedded Devices \section2 Developing for Boot2Qt Devices
Either Windows 7 or later or Ubuntu Linux 64-bit 12.04 LTS or later is Either Windows 7 or later or Ubuntu Linux 64-bit 12.04 LTS or later is
required to install and use Qt for Device Creation. For more information required to install and use Qt for Device Creation. For more information

View File

@@ -1,6 +1,6 @@
/**************************************************************************** /****************************************************************************
** **
** Copyright (C) 2019 The Qt Company Ltd. ** Copyright (C) 2020 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/ ** Contact: https://www.qt.io/licensing/
** **
** This file is part of the Qt Creator documentation. ** This file is part of the Qt Creator documentation.
@@ -31,30 +31,21 @@
You can develop applications for the following platforms: You can develop applications for the following platforms:
\list \list
\li Desktop \li Desktop
\li \l{Connecting Android Devices}{Android}
\li Android \li \l{Connecting Bare Metal Devices}{Bare Metal}
\li Boot2Qt
\li Embedded \li \l{Connecting Generic Remote Linux Devices}{Generic Remote Linux}
\li \l{Connecting iOS Devices}{iOS}
\li Generic remote Linux \li \l{Connecting MCUs}{Microcontroller Units (MCU)} (commercial only)
\li \l{Connecting QNX Devices}{QNX}
\li iOS \li \l{Qt for UWP}{Universal Windows Platform (UWP)}
\li \l{Building Applications for the Web}{WebAssembly}
\li Microcontroller Units (MCU)
\li QNX
\li Universal Windows Platform (UWP)
\li WebAssembly
\endlist \endlist
\section2 Embedded Devices \section2 Boot2Qt Devices
The Boot to Qt stack can be made to run on a variety of hardware. For The Boot2Qt stack can be made to run on a variety of hardware. For
Qt for Device Creation license holders, tooling is provided to customize the Qt for Device Creation license holders, tooling is provided to customize the
contents of the stack as well as to take it into desired production contents of the stack as well as to take it into desired production
hardware. hardware.
@@ -65,8 +56,8 @@
\l{https://doc.qt.io/QtForDeviceCreation/index.html}{Qt for Device Creation} \l{https://doc.qt.io/QtForDeviceCreation/index.html}{Qt for Device Creation}
documentation. documentation.
\note Since \QC 4.9, only Boot to Qt version 5.9 and later are supported. \note Since \QC 4.9, only Boot2Qt version 5.9 and later are supported.
To develop for earlier Boot to Qt versions, use \QC 4.8. To develop for earlier Boot2Qt versions, use \QC 4.8.
\section2 Mobile Devices \section2 Mobile Devices
@@ -99,8 +90,8 @@
\li \li
\row \row
\li MCUs \li MCUs
\li \image ok \li
\li \image ok \li
\li \image ok \li \image ok
\row \row
\li QNX \li QNX

View File

@@ -36,7 +36,7 @@
\title Testing \title Testing
\image creator_testing.png \image front-testing.png
\list \list

View File

@@ -36,7 +36,7 @@
\title Tutorials \title Tutorials
\image creator_gettinghelp.png \image front-help.png
You can use \QC to create applications for several platforms by using You can use \QC to create applications for several platforms by using
several technologies. The tutorials in this manual explain how to create several technologies. The tutorials in this manual explain how to create

View File

@@ -43,7 +43,7 @@
the development environment for Android or iOS. For more information, see the development environment for Android or iOS. For more information, see
\l{Connecting Android Devices} and \l{Connecting iOS Devices}. \l{Connecting Android Devices} and \l{Connecting iOS Devices}.
To run an example application on an embedded device, you must set up To run an example application on a Boot2Qt device, you must set up
Qt for Device Creation on the development host and create connections Qt for Device Creation on the development host and create connections
between the host and devices. For more information, see the between the host and devices. For more information, see the
\l{http://doc.qt.io/QtForDeviceCreation/qtee-installation-guide.html} \l{http://doc.qt.io/QtForDeviceCreation/qtee-installation-guide.html}
@@ -66,7 +66,7 @@
You can also use tags (3) to filter examples. For instance, enter You can also use tags (3) to filter examples. For instance, enter
the \uicontrol Boot2Qt tag (commercial only) in the search field the \uicontrol Boot2Qt tag (commercial only) in the search field
(4) to list examples that you can run on embedded devices. (4) to list examples that you can run on Boot2Qt devices.
\li To check that the application code can be compiled and linked for a \li To check that the application code can be compiled and linked for a
device, click the \uicontrol {Kit Selector} and select a device, click the \uicontrol {Kit Selector} and select a

View File

@@ -36,7 +36,7 @@
\title Building and Running \title Building and Running
\image creator_buildingrunning.png \image front-preview.png
\QC provides support for running and deploying Qt applications built \QC provides support for running and deploying Qt applications built
for different target platforms, or using different compilers, debuggers, or for different target platforms, or using different compilers, debuggers, or

View File

@@ -102,18 +102,18 @@
\list \list
\li Qt Quick Application - Empty \li Qt Quick Application - Empty
Create an empty Qt Quick application that uses Qt Quick 2 types. Create an empty \l{Qt Quick} application that uses Qt Quick 2
types.
You can build the application and deploy it to desktop, You can build the application and deploy it to desktop,
embedded, and mobile target platforms. embedded, and mobile target platforms.
\li Qt Quick Application - Scroll, Stack, or Swipe \li Qt Quick Application - Scroll, Stack, or Swipe
Create a Qt Quick application that uses Create a Qt Quick application that uses \l{Qt Quick Controls} to
\l{http://doc.qt.io/qt-5/qtquickcontrols2-index.html} implement a scrollable list (requires Qt 5.9 or later) or a set
{Qt Quick Controls} to implement a scrollable list (requires of pages with a stack-based or swipe-based navigation model
Qt 5.9 or later) or a set of pages with a stack-based or (requires Qt 5.7 or later).
swipe-based navigation model (requires Qt 5.7 or later).
\endlist \endlist
\li Application (Qt) \li Application (Qt)
@@ -150,8 +150,8 @@
\list \list
\li MCU Support Application \li MCU Support Application
Creates an application that uses a subset of QML and Creates an application that uses a subset of Qt QML and
Qt Quick Controls (as supported by Qt for MCUs) that Qt Quick Controls types (as supported by Qt for MCUs) that
you can deploy, run, and debug on MCU boards. For more you can deploy, run, and debug on MCU boards. For more
information, see \l {Connecting MCUs}. information, see \l {Connecting MCUs}.
\endlist \endlist

View File

@@ -141,10 +141,11 @@
\section1 Providing Deployment Information \section1 Providing Deployment Information
If you want to run your application on an embedded Linux device, you first need to If you want to run your application on a generic remote Linux device,
deploy your executable and possibly other files. \QC does that for you you first need to deploy your executable and possibly other files.
automatically if you provide the necessary information. This works the same \QC does that for you automatically if you provide the necessary
way as explained for CMake \l {Deploying CMake Projects to Embedded Linux Devices}{here}, information. This works the same way as explained for CMake
\l {Deploying CMake Projects to Generic Remote Linux Devices}{here},
except that you also need to include your application binary in the list. except that you also need to include your application binary in the list.
\section1 Creating a Run Configuration \section1 Creating a Run Configuration

View File

@@ -36,7 +36,7 @@
\title Managing Projects \title Managing Projects
\image creator_managingprojects.png \image front-projects.png
One of the major advantages of \QC is that it allows a team of designers and One of the major advantages of \QC is that it allows a team of designers and
developers to share a project across different development platforms with a developers to share a project across different development platforms with a

View File

@@ -84,7 +84,7 @@
\include creator-projects-settings-run-android.qdocinc run settings android \include creator-projects-settings-run-android.qdocinc run settings android
\include creator-projects-settings-run-linux.qdocinc run settings linux \include creator-projects-settings-run-linux.qdocinc run settings linux
\include creator-projects-settings-run-qnx.qdocinc run settings qnx \include creator-projects-settings-run-qnx.qdocinc run settings qnx
\include linux-mobile/creator-projects-settings-run-b2qt.qdocinc run settings embedded \include linux-mobile/creator-projects-settings-run-b2qt.qdocinc run settings boot2qt
\section1 Selecting the Run Environment \section1 Selecting the Run Environment

View File

@@ -1,6 +1,6 @@
/**************************************************************************** /****************************************************************************
** **
** Copyright (C) 2019 The Qt Company Ltd. ** Copyright (C) 2020 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/ ** Contact: https://www.qt.io/licensing/
** **
** This file is part of the Qt Creator documentation. ** This file is part of the Qt Creator documentation.
@@ -47,29 +47,20 @@
devices: devices:
\list \list
\li \l{Connecting Android Devices}{Android Device}
\li Android Device \li \l{Connecting Bare Metal Devices}{Bare Metal Device}
\li \l{https://doc.qt.io/QtForDeviceCreation/b2qt-installation-guides.html}
\li Bare Metal Device {Boot2Qt Device} (commercial only)
\li Boot2Qt Device (commercial only)
\li \l{Emulator}{Boot2Qt Emulator Device} (commercial only) \li \l{Emulator}{Boot2Qt Emulator Device} (commercial only)
\li \l{Connecting Generic Remote Linux Devices}{Generic Remote Linux Device}
\li Generic Linux Device \li \l{Connecting iOS Devices}{iOS Device}
\li iOS Device
\li iOS Simulator \li iOS Simulator
\li \l{Connecting MCUs}{MCU Device} (commercial only)
\li QNX Device \li \l{Connecting QNX Devices}{QNX Device}
\li \l{Building Applications for the Web}{WebAssembly Runtime}
\li Windows Phone \li \l{Qt for UWP}{Windows Phone}
\li Windows Phone Emulator \li Windows Phone Emulator
\li Windows Runtime (local) \li Windows Runtime (local)
\endlist \endlist
\section1 Filtering Kit Settings \section1 Filtering Kit Settings

View File

@@ -41,7 +41,7 @@
\title Deploying Applications to QNX Neutrino Devices \title Deploying Applications to QNX Neutrino Devices
You can deploy applications to QNX Neutrino devices in the way that is You can deploy applications to QNX Neutrino devices in the way that is
described in \l{Deploying Applications to Embedded Linux Devices}. described in \l{Deploying Applications to Generic Remote Linux Devices}.
\image qtcreator-qnx-deployment.png "Deploy to device" \image qtcreator-qnx-deployment.png "Deploy to device"

View File

@@ -42,8 +42,9 @@
\section1 Adding a QNX Neutrino Device in \QC \section1 Adding a QNX Neutrino Device in \QC
Adding a QNX Neutrino device is very similar to \l{Connecting Embedded Adding a QNX Neutrino device is very similar to
Linux Devices}, except you need to select \uicontrol {QNX Device} in the \l{Connecting Generic Remote Linux Devices}, except that
you need to select \uicontrol {QNX Device} in the
\uicontrol {Device Configuration} wizard. \uicontrol {Device Configuration} wizard.
\section1 Adding Kits for QNX Devices \section1 Adding Kits for QNX Devices

View File

@@ -127,7 +127,7 @@
\endlist \endlist
\li \l{Importing 3D Assets} \li \l{Importing 3D Assets}
\li \l{Editing 3D Assets in Design Mode} \li \l{Editing 3D Assets in Design Mode}
\li \l{Working in the 3D Editor} \li \l{Working in 3D Editor}
\li \l{Adding 3D Views} \li \l{Adding 3D Views}
\li \l{Using 3D Components} \li \l{Using 3D Components}
\list \list
@@ -196,14 +196,14 @@
\li \l{Deploying to Devices} \li \l{Deploying to Devices}
\list \list
\li \l{Deploying Applications to Android Devices} \li \l{Deploying Applications to Android Devices}
\li \l{Deploying Applications to Embedded Linux Devices} \li \l{Deploying Applications to Generic Remote Linux Devices}
\li \l{Deploying Applications to QNX Neutrino Devices} \li \l{Deploying Applications to QNX Neutrino Devices}
\endlist \endlist
\li \l{Connecting Devices} \li \l{Connecting Devices}
\list \list
\li \l{Connecting Android Devices} \li \l{Connecting Android Devices}
\li \l{Connecting Bare Metal Devices} \li \l{Connecting Bare Metal Devices}
\li \l{Connecting Embedded Linux Devices} \li \l{Connecting Generic Remote Linux Devices}
\li \l{Connecting iOS Devices} \li \l{Connecting iOS Devices}
\li \l{Connecting MCUs} \li \l{Connecting MCUs}
\li \l{Connecting QNX Devices} \li \l{Connecting QNX Devices}

View File

@@ -54,10 +54,10 @@
\table \table
\row \row
\li \inlineimage creator_gettingstarted.png \li \inlineimage front-gs.png
\li \inlineimage creator_managingprojects.png \li \inlineimage front-projects.png
\li \inlineimage creator_designinguserinterface.png \li \inlineimage front-ui.png
\li \inlineimage creator_coding.png \li \inlineimage front-coding.png
\row \row
\li \b {\l{Getting Started}} \li \b {\l{Getting Started}}
\list \list
@@ -90,10 +90,10 @@
\li \l{Editing State Charts} \li \l{Editing State Charts}
\endlist \endlist
\row \row
\li \inlineimage creator_buildingrunning.png \li \inlineimage front-preview.png
\li \inlineimage creator_testing.png \li \inlineimage front-testing.png
\li \inlineimage creator_advanceduse.png \li \inlineimage front-advanced.png
\li \inlineimage creator_gettinghelp.png \li \inlineimage front-help.png
\row \row
\li \b {\l{Building and Running}} \li \b {\l{Building and Running}}
\list \list

View File

@@ -26,20 +26,23 @@
/*! /*!
//! [scxml state machines] //! [scxml state machines]
\section2 Using SCXML State Machines \section1 Using SCXML State Machines
To use QML together with an SCXML state machine, add states and bind them to To use QML together with an SCXML state machine, add states and
the state machine in the \uicontrol Backends tab in the Design mode, as bind them to the state machine in the \uicontrol Backends tab
of the \uicontrol Connections view, as
described in \l {Managing C++ Backend Objects}. described in \l {Managing C++ Backend Objects}.
In the \uicontrol States view, you can edit the \c when condition of states In the \uicontrol States view, you can select \uicontrol Actions >
\uicontrol {Set when Condition} to edit the \c when condition of states
to map QML states to the states of the SCXML state machine. For an example, to map QML states to the states of the SCXML state machine. For an example,
see \l {Qt SCXML Traffic Light QML Example (Dynamic)}. see \l {Qt SCXML Traffic Light QML Example (Dynamic)}.
\image qmldesigner-states-when-condition.png \image qmldesigner-states-when-condition.png
If you add animation to the states, you can run the application to test the If you add animation to the states, you can \l{Previewing}{preview}
animation. or \l{Running on Multiple Platforms}{run} the application to test
the animation.
//! [scxml state machines] //! [scxml state machines]
*/ */

View File

@@ -51,14 +51,15 @@
\image qmldesigner-qml-components.png "QML Components" \image qmldesigner-qml-components.png "QML Components"
The \uicontrol {QML Types} tab displays the QML types grouped by category: The \uicontrol {QML Types} tab displays the QML types grouped by category,
your own QML components, basic types, layouts, positioner types, and views. such as your own QML components, basic types, layouts, positioner types, and
views.
Sets of UI components with the look and feel of a particular mobile device Sets of UI components with the look and feel of a particular mobile device
platform have been defined for Qt Quick 1. Since Qt 5.1, ready-made Qt platform have been defined for Qt Quick 1. Since Qt 5.1, ready-made Qt
Quick Controls, Dialogs, and Layouts are available for creating user Quick Controls, Dialogs, and Layouts are available for creating user
interfaces using Qt Quick 2. The components and controls are based on interfaces using Qt Quick 2. The components and controls are based on
standard QML types. To view the components and controls in the standard QML types. To view the components and controls in
\uicontrol {Library}, import the component sets in \uicontrol {QML Imports}. \uicontrol {Library}, import the component sets in \uicontrol {QML Imports}.
The \uicontrol {Qt Quick Application} wizards for a particular platform add The \uicontrol {Qt Quick Application} wizards for a particular platform add
@@ -70,21 +71,23 @@
\section1 Adding Components to Designs \section1 Adding Components to Designs
\image studio-design-mode.png "Design mode" \image qmldesigner-editing-components.png "Editing QML components in Design mode"
\list 1 \list 1
\li Drag and drop components from the \uicontrol Library (2) to the \li Drag and drop components from \uicontrol Library (1) to
\uicontrol Navigator (3) or \uicontrol {Form Editor} (1). \uicontrol Navigator (2) or \uicontrol {Form Editor} (3).
\li Select components in the \uicontrol Navigator to edit their \li Select components in \uicontrol Navigator to edit their
properties in the \uicontrol Properties view (4). For more properties in \uicontrol Properties.
information, see \l {Specifying Item Properties}. \image qmldesigner-properties-view.png "Properties view"
For more information, see \l {Specifying Item Properties}.
\li Connect components to signals or create bindings between components \li Connect components to signals or create bindings between components
in the \uicontrol Connections view (5). For more information, see in the \uicontrol Connections view.
\l{Adding Connections}. \image qmldesigner-bindings.png "Connections view Bindings tab"
For more information, see \l{Adding Connections}.
\li Add states to apply sets of changes to the properties of one or \li Add states to apply sets of changes to the properties of one or
several components in the \uicontrol States view (6). For more several components in the \uicontrol States view.
information, see \l{Adding States}. For more information, see \l{Adding States}.
\li Animate component properties in the \uicontrol Timeline view (7). \li Animate component properties in the \uicontrol Timeline view.
For more information, see \l{Creating Animations}. For more information, see \l{Creating Animations}.
\endlist \endlist
@@ -136,12 +139,12 @@
When you add a \l{GridView}{Grid View}, \l{ListView}{List View}, or When you add a \l{GridView}{Grid View}, \l{ListView}{List View}, or
\l{PathView}{Path View}, the ListModel and the delegate component that \l{PathView}{Path View}, the ListModel and the delegate component that
creates an instance for each item in the model are added automatically. creates an instance for each item in the model are added automatically.
You can edit item properties in the \uicontrol Properties view or You can edit item properties in \uicontrol Properties or in
in the \uicontrol {Text Editor}. You can also replace the default model and \uicontrol {Text Editor}. You can also replace the default model and
delegate with other, more complex models and delegates in the delegate with other, more complex models and delegates in
\uicontrol {Text Editor}. \l{ItemDelegate}{Item Delegate} and \uicontrol {Text Editor}. \l{ItemDelegate}{Item Delegate} and
\l{SwipeDelegate}{Swipe Delegate} delegate components are also available \l{SwipeDelegate}{Swipe Delegate} delegate components are also available
in the \uicontrol Library. in \uicontrol Library.
\section1 Positioning Items in UIs \section1 Positioning Items in UIs
@@ -179,7 +182,7 @@
\image qmldesigner-set-expression.png "Type properties context menu" \image qmldesigner-set-expression.png "Type properties context menu"
In the \uicontrol {Binding Editor}, select an item and a property from In \uicontrol {Binding Editor}, select an item and a property from
lists of available items and their properties. lists of available items and their properties.
\image qmldesigner-binding-editor.png "Binding Editor" \image qmldesigner-binding-editor.png "Binding Editor"
@@ -192,7 +195,7 @@
When a binding is set, the \uicontrol Actions menu icon changes to When a binding is set, the \uicontrol Actions menu icon changes to
\inlineimage icons/action-icon-binding \inlineimage icons/action-icon-binding
. To remove bindings, select \uicontrol Reset in the \uicontrol Actions menu. . To remove bindings, select \uicontrol Actions > \uicontrol Reset.
You can set bindings also in the \uicontrol Connections view. For more You can set bindings also in the \uicontrol Connections view. For more
information, see \l {Adding Bindings Between Properties}. information, see \l {Adding Bindings Between Properties}.
@@ -227,7 +230,7 @@
(\uicontrol {Reset Anchors}) button to reset the anchors to their saved (\uicontrol {Reset Anchors}) button to reset the anchors to their saved
state. state.
You can specify the baseline anchor in the \uicontrol {Text Editor} in the You can specify the baseline anchor in \uicontrol {Text Editor} in the
Design mode. Design mode.
For performance reasons, you can only anchor an item to its siblings For performance reasons, you can only anchor an item to its siblings
@@ -340,8 +343,9 @@
\endlist \endlist
To position several items in a \uicontrol Column, \uicontrol Row, To position several items in a \uicontrol Column, \uicontrol Row,
\uicontrol Grid, or \uicontrol Flow, select the items on the canvas, and \uicontrol Grid, or \uicontrol Flow, select the items in
then select \uicontrol Position in the context menu. \uicontrol {Form Editor}, and then select \uicontrol Position in
the context menu.
\section2 Using Layouts \section2 Using Layouts
@@ -353,8 +357,6 @@
You can use the following layout types to arrange items in UIs: You can use the following layout types to arrange items in UIs:
\list \list
\li \l{Layout} provides attached properties for items pushed onto a
column, row, or grid layout.
\li \l{ColumnLayout}{Column Layout} provides a grid layout with only \li \l{ColumnLayout}{Column Layout} provides a grid layout with only
one column. one column.
\li \l{RowLayout}{Row Layout} provides a grid layout with only one row. \li \l{RowLayout}{Row Layout} provides a grid layout with only one row.
@@ -365,7 +367,7 @@
\endlist \endlist
To lay out several items in a column, row, grid, or To lay out several items in a column, row, grid, or
\uicontrol {Stack Layout}, select the items in the \uicontrol {Form Editor}, \uicontrol {Stack Layout}, select the items in \uicontrol {Form Editor},
and then select \uicontrol Layout in the context menu. and then select \uicontrol Layout in the context menu.
You can also click the \inlineimage column.png You can also click the \inlineimage column.png
@@ -374,9 +376,9 @@
(\uicontrol {Grid Layout}) toolbar buttons to apply (\uicontrol {Grid Layout}) toolbar buttons to apply
layouts to the selected items. layouts to the selected items.
To make an item within a layout as wide as possible while respecting To make an item within a layout as wide as possible while respecting the
the given constraints, select the item on the canvas and then select given constraints, select the item in \uicontrol {Form Editor}, and then
\uicontrol Layout > \uicontrol {Fill Width} in the context menu. To select \uicontrol Layout > \uicontrol {Fill Width} in the context menu. To
make the item as high as possible, select \uicontrol {Fill Height}. make the item as high as possible, select \uicontrol {Fill Height}.
\section2 Editing Stack Layouts \section2 Editing Stack Layouts
@@ -385,7 +387,7 @@
To add items to a \uicontrol {Stack Layout}, select the To add items to a \uicontrol {Stack Layout}, select the
\inlineimage plus.png \inlineimage plus.png
button next to the type name in the \uicontrol {Form Editor}. To move button next to the type name in \uicontrol {Form Editor}. To move
between items, select the \inlineimage prev.png between items, select the \inlineimage prev.png
(\uicontrol Previous) and \inlineimage next.png (\uicontrol Previous) and \inlineimage next.png
(\uicontrol Next) buttons. (\uicontrol Next) buttons.
@@ -550,22 +552,22 @@
\endif \endif
\uicontrol Choose to create a new .qml file. \uicontrol Choose to create a new .qml file.
\note Components are listed in the \uicontrol {QML Components} section of \note Components are listed in the \uicontrol {My QML Components}
the \uicontrol Library only if the filename begins with a capital tab in the \uicontrol Library view only if the filename begins with
letter. a capital letter.
\li Click \uicontrol Design to open the .qml file in the Design mode. \li Click \uicontrol Design to open the .qml file in the Design mode.
\li Drag and drop a QML type from the \uicontrol Library to the \li Drag and drop a QML type from \uicontrol Library to
\uicontrol Navigator or \uicontrol {Form Editor}. \uicontrol Navigator or \uicontrol {Form Editor}.
\li Edit its properties in the \uicontrol Properties view. \li Edit its properties in \uicontrol Properties.
The available properties depend on the QML type. The available properties depend on the QML type.
\endlist \endlist
The following sections contain more information about how to use the The following sections contain more information about how to use
\uicontrol {Form Editor} to edit 2D content, as well as examples of \uicontrol {Form Editor} to edit 2D content, as well as examples of
how to create some common components using basic QML types: how to create some common components using basic QML types:
@@ -582,10 +584,11 @@
\section1 Moving Within Components \section1 Moving Within Components
Components can consist of several other components. To view the component Components can consist of several other components. To view the component
hierarchy as a bread crumb path when you edit a component on the canvas, hierarchy as a bread crumb path when you edit a component in
select \uicontrol {Go into Component} or press \key F2. Click the component \uicontrol {Form Editor}, select \uicontrol {Go into Component} or press
names in the path to navigate to them. You can easily navigate back to the \key F2. Click the component names in the path to navigate to them. You
top level when you are done editing the component. can easily navigate back to the top level when you are done editing the
component.
\image qmldesigner-breadcrumbs.png "Go into Component command" \image qmldesigner-breadcrumbs.png "Go into Component command"
*/ */

View File

@@ -50,7 +50,7 @@
until it is explicitly assigned a new value. However, to make the fullest until it is explicitly assigned a new value. However, to make the fullest
use of QML and its built-in support for dynamic object behaviors, most QML use of QML and its built-in support for dynamic object behaviors, most QML
types use property bindings. This means that you can specify relationships types use property bindings. This means that you can specify relationships
between different object properties so that when a property's sependencies between different object properties so that when a property's dependencies
change in value, the property's value is automatically updated accordingly. change in value, the property's value is automatically updated accordingly.
Behind the scenes, the QML engine monitors the property's dependencies (that Behind the scenes, the QML engine monitors the property's dependencies (that

View File

@@ -1,6 +1,6 @@
/**************************************************************************** /****************************************************************************
** **
** Copyright (C) 2019 The Qt Company Ltd. ** Copyright (C) 2020 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/ ** Contact: https://www.qt.io/licensing/
** **
** This file is part of the Qt Design Studio documentation. ** This file is part of the Qt Design Studio documentation.
@@ -34,7 +34,7 @@
To preview UIs on Android devices, you need to enable USB debugging on them To preview UIs on Android devices, you need to enable USB debugging on them
and connect them to your system with a USB cable. and connect them to your system with a USB cable.
\endomit \endomit
To preview UIs on embedded devices, you need to connect the devices to your To preview UIs on Boot2Qt devices, you need to connect the devices to your
system with a USB cable, or a wired or wireless connection, depending on system with a USB cable, or a wired or wireless connection, depending on
the device, and configure connections to them. The necessary kits have been the device, and configure connections to them. The necessary kits have been
predefined and you only need to enable them for your current project. predefined and you only need to enable them for your current project.
@@ -79,9 +79,9 @@
device. device.
\endomit \endomit
\section2 Previewing on Embedded Devices \section2 Previewing on Boot2Qt Devices
You can preview UIs on embedded devices that are supported by You can preview UIs on Boot2Qt devices that are supported by
\l{Qt for Device Creation}. For a list of supported devices, see \l{Qt for Device Creation}. For a list of supported devices, see
\l{https://doc.qt.io/QtForDeviceCreation/qtee-supported-platforms.html#reference-target-devices} \l{https://doc.qt.io/QtForDeviceCreation/qtee-supported-platforms.html#reference-target-devices}
{Reference Target Devices}. {Reference Target Devices}.

View File

@@ -37,7 +37,7 @@
The bottom part of the view displays properties that are specific to each The bottom part of the view displays properties that are specific to each
QML type. For example, the following image displays the properties you can QML type. For example, the following image displays the properties you can
set for \uicontrol Rectangle (1) and \uicontrol Text (2) items. set for \uicontrol Rectangle and \uicontrol Text items.
\image qmldesigner-element-properties.png \image qmldesigner-element-properties.png

View File

@@ -55,57 +55,60 @@
\list \list
\li Show some UI items and hide others. \li Show some UI items and hide others.
\li Present different available actions to the user. \li Present different available actions to the user.
\li Start, stop or pause animations. \li Start, stop, or pause animations.
\li Execute some script required in the new state. \li Execute some script required in the new state.
\li Change a property value for a particular item. \li Change a property value for a particular item.
\li Show a different view. \li Show a different view.
\endlist \endlist
\section1 Creating States
The \uicontrol States view displays the different \l{State}{states} The \uicontrol States view displays the different \l{State}{states}
of the component in the Design mode. The \uicontrol States view is of a UI, beginning with a \e {base state}.
collapsed by default to save space. Select \uicontrol Expand in
the context menu to view the whole view.
\image qmldesigner-transitions.png "States view" \image qmldesigner-transitions.png "States view"
To add states, click the \inlineimage plus.png To add states, click the \inlineimage plus.png
button. Then modify the new state in the editor. For example, to change the button. Click the new state to switch to it in \uicontrol {Form Editor},
appearance of a button, you can hide the button image and show another image and then modify the properties of components in \uicontrol Properties.
in its place. Or, to add movement to the view, you can change the position
of an object on the canvas and then add animation to the change between the
states.
To determine when the state should be applied, select For example, to change the appearance of a button, you can hide the button
\uicontrol {Set when Condition} in the menu and specify a image and show another image in its place. Or, to add movement to the view,
\l [QtQuick]{State::when}{when} property for the state. you can change the position of an object in \uicontrol {Form Editor}
Set the value of the property to an expression that and then add animation to the change between the states.
evaluates to \c true when you want the state to be applied.
In the binding editor, select the component and property to
create the expression. For example, to change the state when
a button is pressed, you could select a button component and
its pressed property.
\image qtquick-states-binding-editor.png "Binding editor in States view"
You can preview the states in the \uicontrol States view and click them to
switch between states on the canvas.
\section1 Using States
QML states typically describe user interface configurations, such as the UI
controls, their properties and behavior and the available actions. For
example, you can use states to create two views.
To add states, click the empty slot in the \uicontrol States view.
Then modify the new state in the \uicontrol {Form Editor} or the
\uicontrol Properties view.
\image qmldesigner-states.png "States view"
The properties that you change in a state are highlighted with blue color. The properties that you change in a state are highlighted with blue color.
In the \uicontrol {Text Editor}, you can see the changes recorded as changes In \uicontrol {Text Editor}, you can see the changes recorded as changes
to the base state. to the base state.
\image qmldesigner-states.png "States and Properties views"
\section1 Setting the Default State
To determine the startup state of the application,
select \inlineimage icons/action-icon.png
to open the \uicontrol Actions menu, and then select
\uicontrol {Set as Default}.
To reset the state later, select \uicontrol Actions >
\uicontrol {Reset Default}.
\section1 Applying States
To determine when a state should be applied, select \uicontrol Actions >
\uicontrol {Set when Condition}. In \uicontrol {Binding Editor}, specify
a \l [QtQuick]{State::when}{when} property for the state. Set the value of
the property to an expression that evaluates to \c true when you want the
state to be applied.
In \uicontrol {Binding Editor}, select the component and property to
create the expression. For example, to change the state when a button is
pressed, you could select a button component and its pressed property.
\image qtquick-states-binding-editor.png "Binding Editor in States view"
\section1 Using States
To keep the QML code clean, you should create a base state that contains all To keep the QML code clean, you should create a base state that contains all
the types you will need in the application. You can then create states, the types you will need in the application. You can then create states,
in which you hide and show a set of items and modify their properties. in which you hide and show a set of items and modify their properties.
@@ -124,29 +127,23 @@
To create views for an application by using states: To create views for an application by using states:
\image qmldesigner-screen-design.png "Designing views"
\list 1 \list 1
\li In the base state, add all items you will need in the application \li In the base state, add all items you will need in the application
(1). While you work on one view, you can click the (1). While you work on one view, you can click the
\inlineimage eye_open.png \inlineimage eye_open.png
icon to hide items on the canvas that are not part of a view. icon to hide items on the canvas that are not part of a view.
\li In the \uicontrol States view, click the empty slot to create a \li In \uicontrol States, click the empty slot to create a
new state and give it a name. For example, \c Normal. new state and give it a name. For example, \c Normal.
\li In the \uicontrol Properties view (2), deselect the \li In \uicontrol Properties (2), deselect the \uicontrol Visibility
\uicontrol Visibility check box or set \uicontrol Opacity to 0 check box or set \uicontrol Opacity to 0 for each item that is not
for each item that is not needed in this view. If you specify needed in this view. If you specify the setting for the parent item,
the setting for the parent item, all child items inherit it and all child items inherit it and are also hidden.
are also hidden.
\image qmldesigner-screen-design.png "Designing views"
\li Create additional states for each view and set the visibility \li Create additional states for each view and set the visibility
or opacity of the items in the view. or opacity of the items in the view.
\li To determine which view opens when the application starts, use the \li To determine which state is applied when the application starts,
\uicontrol {Text Editor} to set the state of the root item of the select \uicontrol Actions > \uicontrol {Set as Default}.
.qml file, as specified by the following code snippet:
\qml
Item {
state: "Normal"
}
\endqml
\endlist \endlist
\if defined(qtcreator) \if defined(qtcreator)
@@ -165,7 +162,7 @@
the type of behavior that is required. the type of behavior that is required.
You can drag and drop the following QML types from \uicontrol Library You can drag and drop the following QML types from \uicontrol Library
> \uicontrol {QML Types} > \uicontrol {Qt Quick - Animation} to the > \uicontrol {QML Types} > \uicontrol {Qt Quick - Animation} to
\uicontrol Navigator or \uicontrol {Form Editor}: \uicontrol Navigator or \uicontrol {Form Editor}:
\list \list
@@ -181,8 +178,8 @@
sequential animation to create a step where nothing happens, for sequential animation to create a step where nothing happens, for
a specified duration. a specified duration.
\li \l [QML] {PropertyAction}{Property Action} immediately changes \li \l [QML] {PropertyAction}{Property Action} immediately changes
a propertyvalue during an animation, without animating the property a property value during an animation, without animating the
change. property change.
\li \l [QML] {PropertyAnimation}{Property Animation} animates \li \l [QML] {PropertyAnimation}{Property Animation} animates
changes in the value of a property. changes in the value of a property.
\li \l [QML] {ScriptAction}{Script Action} defines scripts to be \li \l [QML] {ScriptAction}{Script Action} defines scripts to be

View File

@@ -110,10 +110,6 @@ qhp.qtdesignstudio.subprojects.manual.type = manual
# Doxygen compatibility commands # Doxygen compatibility commands
macro.see = "\\sa" macro.see = "\\sa"
macro.function = "\\fn" macro.function = "\\fn"
macro.QB = "Qt Bridge"
macro.QBPS = "Qt Bridge for Adobe Photoshop"
macro.QBSK = "Qt Bridge for Sketch"
macro.QDS = "Qt Design Studio"
navigation.landingpage = "$IDE_DISPLAY_NAME Manual" navigation.landingpage = "$IDE_DISPLAY_NAME Manual"
buildversion = "$IDE_DISPLAY_NAME Manual $QTC_VERSION" buildversion = "$IDE_DISPLAY_NAME Manual $QTC_VERSION"

View File

@@ -32,7 +32,6 @@
\brief Illustrates how to use the timeline and states to animate UI \brief Illustrates how to use the timeline and states to animate UI
components. components.
\previouspage {Log In UI - Part 3} \previouspage {Log In UI - Part 3}
\nextpage {Log In UI - Part 5}
\image loginui4.gif "Log In UI" \image loginui4.gif "Log In UI"

View File

@@ -24,7 +24,7 @@
****************************************************************************/ ****************************************************************************/
/*! /*!
\example ProgressBar \example progressbar
\ingroup studioexamples \ingroup studioexamples
\title Progress Bar \title Progress Bar

Binary file not shown.

Before

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 21 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 25 KiB

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 20 KiB

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 22 KiB

After

Width:  |  Height:  |  Size: 25 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 20 KiB

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 25 KiB

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 32 KiB

After

Width:  |  Height:  |  Size: 21 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.6 KiB

After

Width:  |  Height:  |  Size: 2.4 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 5.9 KiB

After

Width:  |  Height:  |  Size: 4.6 KiB

View File

@@ -0,0 +1,57 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- Generator: Adobe Illustrator 24.1.2, SVG Export Plug-In . SVG Version: 6.00 Build 0) -->
<svg version="1.1" baseProfile="tiny" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"
x="0px" y="0px" viewBox="0 0 450 270" overflow="visible" xml:space="preserve">
<g>
<g>
<path fill="#C9C7C7" d="M433.8,269.6H16.2c-7.8,0-14.2-6.4-14.2-14.2V14.2C2,6.4,8.4,0,16.2,0h417.6c7.8,0,14.2,6.4,14.2,14.2
v241.2C448,263.2,441.6,269.6,433.8,269.6z"/>
<path fill="#878686" d="M2.4,19.5L2,14.1C2,6.3,8.3,0,16.1,0h417.9c7.8,0,14.1,6.3,14.1,14.1v6.8"/>
<circle fill="#DD5858" cx="19.3" cy="10.6" r="5"/>
<circle fill="#DBC558" cx="36.1" cy="10.6" r="5"/>
<circle fill="#52B257" cx="52.9" cy="10.6" r="5"/>
</g>
<path fill="#FFFFFF" d="M437.1,262.2H13.4c-2.8,0-5-2.2-5-5V185c0-2.8,2.2-5,5-5h423.7c2.8,0,5,2.2,5,5v72.2
C442.1,260,439.9,262.2,437.1,262.2z"/>
<path fill="none" stroke="#FFFFFF" stroke-width="7.4167" stroke-linecap="round" stroke-miterlimit="10" d="M190.6,91.4
c0-24.3,19.7-44.1,44.1-44.1s44.1,19.7,44.1,44.1s-19.7,44.1-44.1,44.1"/>
<circle fill="#FFFFFF" cx="233.8" cy="91.1" r="19.7"/>
<polygon fill="#878686" points="258.9,158 256.2,193.9 267.4,180.3 284.4,183.1 "/>
<path fill="#878686" d="M228.2,195.9H19.4c-2.8,0-5-2.2-5-5V188c0-2.8,2.2-5,5-5h208.8c2.8,0,5,2.2,5,5v2.9
C233.2,193.6,231,195.9,228.2,195.9z"/>
<path fill="#878686" d="M348,223.6H206.5c-2.8,0-5-2.2-5-5v-2.9c0-2.8,2.2-5,5-5H348c2.8,0,5,2.2,5,5v2.9
C353,221.4,350.8,223.6,348,223.6z"/>
<path fill="#878686" d="M419.3,247.4h-86.1c-2.8,0-5-2.2-5-5v-2.9c0-2.8,2.2-5,5-5h86.1c2.8,0,5,2.2,5,5v2.9
C424.3,245.1,422.1,247.4,419.3,247.4z"/>
<rect x="222.4" y="199" transform="matrix(0.7071 -0.7071 0.7071 0.7071 -77.0099 218.9356)" fill="#878686" width="6.8" height="6.8"/>
<rect x="18.4" y="199" transform="matrix(0.7071 -0.7071 0.7071 0.7071 -136.7589 74.6888)" fill="#878686" width="6.8" height="6.8"/>
<rect x="117.4" y="199" transform="matrix(0.7071 -0.7071 0.7071 0.7071 -107.7546 144.7115)" fill="#878686" width="6.8" height="6.8"/>
<rect x="210.5" y="226.7" transform="matrix(0.7071 -0.7071 0.7071 0.7071 -100.0968 218.6541)" fill="#878686" width="6.8" height="6.8"/>
<rect x="307.5" y="226.7" transform="matrix(0.7071 -0.7071 0.7071 0.7071 -71.6725 287.2764)" fill="#878686" width="6.8" height="6.8"/>
<rect x="338.2" y="251.5" transform="matrix(0.7071 -0.7071 0.7071 0.7071 -80.1869 316.2345)" fill="#878686" width="6.8" height="6.8"/>
<rect x="410.5" y="251.5" transform="matrix(0.7071 -0.7071 0.7071 0.7071 -59.0137 367.3511)" fill="#878686" width="6.8" height="6.8"/>
<g>
<path fill="#FFFFFF" d="M175.7,73.5v14h-2.9V76.8l-3,1.9l-1.3-2.2l4.6-3.1H175.7z"/>
</g>
<g>
<path fill="#FFFFFF" d="M290.4,59.2h-9.1v-2.5l3-3c1.1-1.1,1.8-1.9,2.2-2.5s0.6-1.2,0.6-1.9c0-0.7-0.2-1.1-0.5-1.4
c-0.3-0.3-0.8-0.4-1.5-0.4c-0.9,0-2,0.1-3.1,0.3l-0.5,0.1l-0.1-2.3c1.4-0.4,2.8-0.6,4.3-0.6c3,0,4.4,1.3,4.4,4
c0,1-0.2,1.9-0.7,2.7s-1.3,1.7-2.5,2.8l-2.4,2.2h5.8V59.2z"/>
</g>
<g>
<path fill="#8389A8" d="M238.9,145.1c1.6-0.6,3.5-1,5.5-1c2,0,3.5,0.4,4.4,1.2s1.4,2,1.4,3.7c0,1.7-0.7,3-2.1,3.9
c0.9,0.5,1.5,0.9,1.8,1.4s0.5,1.3,0.5,2.4c0,1.9-0.5,3.3-1.4,4.3c-1,0.9-2.5,1.4-4.6,1.4c-1.6,0-3.2-0.2-4.9-0.7l-0.9-0.2l0.2-2.8
c2,0.3,3.7,0.5,5,0.5c1.8,0,2.8-0.8,2.8-2.4c0-0.7-0.2-1.2-0.7-1.6c-0.5-0.4-1.1-0.6-1.9-0.6h-3.6v-3h3.6c0.6,0,1.1-0.2,1.6-0.7
c0.5-0.5,0.7-1.1,0.7-1.7c0-1.3-0.9-1.9-2.6-1.9c-1.2,0-2.5,0.1-3.9,0.4l-0.7,0.1L238.9,145.1z"/>
</g>
<line fill="none" stroke="#F9D953" stroke-width="3" stroke-miterlimit="10" x1="103.5" y1="269.2" x2="103.5" y2="165.2"/>
<polygon fill="#F9D953" points="103.4,178.2 111.2,164.7 95.6,164.7 "/>
</g>
</svg>

After

Width:  |  Height:  |  Size: 3.7 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.9 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.9 KiB

Some files were not shown because too many files have changed in this diff Show More