From Qt Wiki
Jump to: navigation, search
This article may require cleanup to meet the Qt Wiki's quality standards. Reason: Auto-imported from ExpressionEngine.
Please improve this article if you can. Remove the {{cleanup}} tag and add this page to Updated pages list after it's clean.

Qt Quick Controls (Former Qt Desktop Components)

This project aims to deliver Qt Quick components relevant to desktop developers. This includes things like layouts, menus and styling.

IRC channel: #qt-components on irc.freenode.org


The project focus is to get the current components set working as well as possible for the Qt 5.1 release.

Source Code Access

git clone ssh://<username>@codereview.qt.io:29418/qt/qtquickcontrols.git

Use the "stable" branch and compile against a recent build of Qt 5.1 (qt "stable" branch)

Gitorious mirror: http://qt.gitorious.org/qt/qtquickcontrols

Bug Tracking

Use bugreports.qt.io, Project "Qt", Component "QtQuick: Controls" or "QtQuick: Layouts".

Filter for viewing all unresolved bugs.


The components rely on several C++ plugins in order to integrate with the desktop. To install the components into your Qt directory, simply enter the root directory and do:

make install

This will compile and copy the plugins and components into your QTDIR/qml folder. If you are compiling against a system Qt on linux, you might have to do a 'sudo make install' in order to install the project.


The examples should show how you can use the components.

There is a video demonstration available at http://www.youtube.com/watch?v=Y1pqL5bXe0A

If you are using the QtQuick 2.0 wizard in Qt Creator there are two issues you should be aware of: - you cannot have a Window (or ApplicationWindow) as the root item. To do this, you need to change your QtQuickView into a QtQmlEngine since Window is not a QtQuickItem. - You have to change QGuiApplication to a QApplication. This is because the components rely on certain widget-specific classes such as QStyle to do native rendering.

API Development Process Ideas

  • Process to happen on mailing list (subscribe here: http://lists.qt.io/mailman/listinfo/qt-components ).
  • When making API proposal/change always include: API definition and real world example (from a developer standpoint).
  • Once decided upon an API proposal/change documentation has to be written right away.
  • Enforcing a timeline around API discussion: from start of API definition to decision on it: 1 week.
  • Making sure that at least one representant of each interested platform validates the API (if possible).
  • Try to follow Qt naming convention if unsure.
  • In case of unresolvable conflict of opinions, an appointed maintainer will have the last word.

Blogs entries

http://blog.qt.io/2011/03/10/qml-components-for-desktop/ http://blog.qt.io/2011/05/26/table-view-with-qt-quick/ http://blog.qt.io/2011/08/26/toplevel-windows-and-menus-with-qt-quick/ http://blog.qt.io/2012/06/06/desktop-components-for-qt-5/