Revision as of 07:55, 26 September 2011

Development/Tutorials/Using Qt Creator

QtCreator is an IDE from Nokia for Qt. It contains QtDesigner for UI design. This article describes:

why use Qt Creator
how to create a new program
how to load an existing program

Why use Qt Creator

KDE4's ktimetracker loaded as QtCreator project

To create your C++ programs you can use any text editor. But life will be much easier if you gain Qt Creator's features, that means

you can get your source code saved, built and run on one click
you get code-completion
you can find all places in your source code where you call a function (e.g. "where do I call refresh()")
you can go back to a more recent cursor-position with your editor, even if this is in another file
you can checkout and check in to a subversion or git repository without leaving your workflow

Creating a new program

Here is a short example how you can create a "hello world" program. For more information read the user documentation.

Step 0

Call Qt Creator

qtcreator

Then select New File or Project -> Qt C++ Project -> Qt Gui Application -> name = helloworld -> Next -> Next -> Finish

Step 1

Select Edit -> Forms -> mainwindow.ui. Add the widgets you want by drag-and-drop:

Step 2

Select the mainwindow. This is the one un-intuitive step. To lay out the objects in the mainwindow, you do not select the objects in the mainwindow, but the mainwindow itself.

Step 3

Select Form -> Lay Out in a Grid

Result

You get a decent look, and if you resize the window, the widgets resize as well.

Using KDE libraries

To use KDE classes like KMessageBox, you need to tell qtcreator to use the KDE libraries when building. Go to your home directory, cd into yourproject and modify yourproject.pro. Add a line

LIBS += -lkdeui

Then you can start using KDE classes in your code.

Adding a toolbar

To add a toolbar, right-click on the UI and choose "Add Toolbar". Then you can set icons and text in your mainwindow's constructor with code like this:

ui->toolBar->addAction(QIcon("/usr/share/icons/oxygen/22x22/apps/ktip.png"),"hello world");

More Info...

Load an existing project

This describes how to use QtCreator to integrate existing KDE 4 applications. It has been tested with QtCreator 1.2.80 and SUSE Linux 11.1 but should work same or similar with every combination. As an example KDE application we use ktimetracker from the kdepim module, other applications should work analog.

You can either work with code on your disk or have QtCreator do the subversion checkout.

use code from your disk

Import the CMakeLists.txt file (File -> Open -> kdepim/CMakeLists.txt)
As build directory choose kdepim.
You will automatically come to a screen where you can run cmake
Continue with the step "Run cmake"

have QtCreator do the subversion checkout

Choose File -> New File or Project -> Version Control -> Subversion Checkout.
Enter a subversion URL like svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepim
Enter a checkout directory, so the local directory where the checkout will be loaded in
Type finish, see how the checkout starts
You will automatically come to a screen where you can run cmake
Continue with the step "Run cmake"

have QtCreator do the git checkout

Choose File -> New File or Project -> Version Control -> Git Checkout.
Enter a git URL like [email protected]:/kdepim
accept kdepim as checkout directory
Type finish, see how the checkout starts
You will automatically come to a screen where you can run cmake
Continue with the step "Run cmake"

Run cmake

Enter arguments for cmake like

/root/kdepim -DCMAKE_INSTALL_PREFIX=/usr/local -DLIB_SUFFIX=64 -DCMAKE_BUILD_TYPE=debugfull

DLIB_SUFFIX=64 means that you want to install your libraries into directories named lib64, not lib. /root/kdepim is where your source code is.

click "Run cmake"
Note a .cbp file gets created containing many information about the build.
click "Finish"

Build it

Configure qtcreator to build only ktimetracker:

Projects -> Active run configuration=ktimetracker -> build settings -> build steps -> make -> show details -> activate ktimetracker.

Configure qtcreator to use 8 logical processors:

Projects -> Active run configuration=ktimetracker -> build settings -> build steps -> make -> show details -> addtional Arguments = -j8

Choose Build -> Build All

@@ Line 7: / Line 7: @@
 = Why use Qt Creator =
-[[Image:Snapshot-qtcreator.png]]
+{|align="right"
+|[[image:Snapshot-qtcreator.png|right|thumb|200px|KDE4's ktimetracker loaded as QtCreator project]]
+|}
+To create your C++ programs you can use any text editor. But life will be much easier if you gain Qt Creator's features, that means
+* you can get your source code saved, built and run on one click
+* you get code-completion
+* you can find all places in your source code where you call a function (e.g. "where do I call refresh()")
+* you can go back to a more recent cursor-position with your editor, even if this is in another file
+* you can checkout and check in to a subversion or git repository without leaving your workflow
 = Creating a new program =
 Here is a short example how you can create a "hello world" program. For more information read the [http://qt.nokia.com/doc/designer-manual.html user documentation].

Development/Tutorials/Using Qt Creator: Difference between revisions