Creating Projects

Creating a project enables you to:

  • Group files together
  • Include forms and assets files
  • Specify settings for previewing UIs

Setting up a new project in Qt Design Studio is aided by a wizard that guides you step-by-step through the project creation process. The wizards prompt you to enter the settings needed for that particular type of project and create the necessary files for you.

Studio projects are useful for creating UIs. You cannot use them for application development, because they do not contain:

  • C++ code
  • Resource files (.qrc)
  • Code needed for deploying applications to devices.

Because the UIs do not contain any C++ code, you do not need to build them. To test how well your designs work, you can preview the UIs on the desktop or embedded Linux devices. For more information, see Previewing.

"A list of project wizards"

You can export designs from other design tools and import them to projects or create them from scratch using the following wizards:

  • Qt for MCUs Application creates an application that uses a subset of Qt QML and Qt Quick Controls types (as supported by Qt for MCUs) that you can deploy, run, and debug on MCU boards.
  • Qt Quick Application - Empty creates a Qt Quick UI project that uses Qt Quick types and can be run on all target platforms.
  • Qt Quick 3D Application creates a Qt Quick UI project that uses Qt Quick and Qt Quick 3D types.
  • Qt Quick Application - Scroll and Qt Quick Application - Stack create a Qt Quick application that uses Qt Quick Controls to implement a scrollable list or a set of pages with a stack-based navigation model.
  • Qt Quick Application - Launcher creates a Qt Quick UI project that uses Qt Quick types and defines a QML laucher application.

For an example of creating a Qt Quick 3D Application project, watch the following video:

Using Project Wizards

  1. Select File > New File or Project.
  2. Select the type of your project, and then select Choose.
  3. In the Name field, enter a name for the project.
  4. In the Create in field, enter the path for the project files, and then select Next (or Continue on macOS).
  5. In the Screen resolution field, select the screen resolution for previewing the UI on the desktop or on a device.
  6. In the Qt Quick Controls Style field, select one of the predefined UI styles to use, and then select Finish (or Done on macOS).

Qt Design Studio creates the following files and folders:

  • .qmlproject project file defines that all QML, JavaScript, and image files in the project folder belong to the project. Therefore, you do not need to individually list all the files in the project.
  • .qml file defines a UI item, such as a component, screen, or the whole UI.
  • ui.qml file defines a form for the UI.
  • qtquickcontrols2.conf file specifies the preferred style and some style-specific arguments.
  • imports folder contains a Constants.qml file that specifies a font loader for the Arial font and the screen resolution. The size of the default Screen.ui.qml Rectangle should be set as width: Constants.width & height: Constants.height, so it inherits the global resolution saved here.
  • qmldir module definition file declares the Constant QML type. For more information, see Module Definition qmldir Files.
  • In addition, the QtQuick subfolder contains the Studio components and effects QML types.

To use JavaScript and image files in the UI, select Library > Assets > Add New Assets.

Adding Files to Projects

You can use wizards also to add individual files to your projects. You can create the following types of files:

  • Qt Quick Files
    • Flow Item and Flow View generate types that you can use to design the application flow.
    • Qt Quick File generates a QML type with one of the following basic types or positioners as the root item: Item, Rectangle, Image, Border Image, Flickable, Row, Column, Flow, or Grid.
    • Qt Quick UI File generates a UI form with one of the above types as the root item.
    • Qt Quick Views generates a Grid View or a List View. For more information, see List and Grid Views.
  • Qt Quick Controls
    • Custom Button creates a push button with a text label.
    • Custom Switch creates a switch with on and off states.
    • Pane provides a background that matches the UI style and theme.
    • StackView provides a stack-based navigation model.
    • SwipeView enables users to navigate pages by swiping sideways.
  • ListModel adds a list model to the project.
  • JavaScript File generates files that you can use to write the application logic. This is useful for testing the application before the developers implement the application logic in C++, for example. For more information, see Simulating Application Logic.

Available under certain Qt licenses.
Find out more.