Qt Quick Controls 1 Overview

The Qt Quick Controls provide a set of UI controls to create user interfaces in Qt Quick.

Getting Started

The QML types can be imported into your application using the following import statement in your .qml file.

import QtQuick.Controls 1.2

Creating a basic example

A basic example of a QML file that makes use of controls is shown here:

import QtQuick.Controls 1.2

ApplicationWindow {
    title: "My Application"
    width: 640
    height: 480
    visible: true

    Button {
        text: "Push Me"
        anchors.centerIn: parent
    }
}

For an overview of the controls provided by Qt Quick Controls 1, you can look at the Gallery example.

Setting Up Controls from C++

Although we have traditionally used a QQuickView window to display QML files in a C++ application, doing this means you can only set window properties from C++.

With Qt Quick Controls, declare an ApplicationWindow as the root item of your application and launch it by using the QQmlApplicationEngine instead. This ensures that you can control top level window properties from QML.

A basic example of a source file that makes use of controls is shown here:

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QQmlApplicationEngine engine("main.qml");
    return app.exec();
}

Using C++ Data From QML

If you need to register a C++ class to use from QML, you can call, for example, qmlRegisterType() before declaring your QQmlApplicationEngine. You can find the list of all registering functions here.

If you need to expose data to QML components, you need to set them to the context of the current QML engine. See QQmlContext for more information.

Deploying Qt Quick Controls

Since Qt 5.2, the Qt Quick Controls JavaScript and QML files are embedded into the plugin using Qt resources (.qrc) for the QtQuick.Controls and QtQuick.Controls.Styles imports. It is only necessary to deploy the qtquickcontrolsplugin C++ library and its qmldir file found in the plugin directory qml/QtQuick/Controls.

The .js/.qml files are still placed into the plugin directory though for keeping the development tasks convenient, debugging and autocompletion capabilities remain unchanged. For deployment, these files can be ignored. In practice, the Styles and Private subfolders can be deleted as well as all .js and .qml files present under qml/QtQuick/Controls.

Using resources facilitates the deployment of the Qt Quick Controls though it has limitations that still need to be addressed.

Testing Desktop and Mobile behavior of the controls

You can test how the controls on your application or style will behave on a mobile platform by setting the environment variable QT_QUICK_CONTROLS_MOBILE, to force a behavior optimized for mobile devices.

Related information

• Qt Quick
• Qt Quick Controls 1
• Qt Quick Controls 1 Examples