Development/Tutorials/Using Qt Creator: Difference between revisions

    From KDE TechBase
    m (Fix syntax highlighting.)
    m (→‎Run cmake: Fix syntax highlighting.)
    Line 78: Line 78:
    == Run cmake ==
    == Run cmake ==
    * Enter arguments for cmake like  
    * Enter arguments for cmake like  
    <pre>
    <syntaxhighlight lang="bash">
    /root/kdepim -DCMAKE_INSTALL_PREFIX=/usr/local -DLIB_SUFFIX=64 -DCMAKE_BUILD_TYPE=debugfull
    /root/kdepim -DCMAKE_INSTALL_PREFIX=/usr/local -DLIB_SUFFIX=64 -DCMAKE_BUILD_TYPE=debugfull
    </pre>
    </syntaxhighlight>
    <tt>DLIB_SUFFIX=64</tt> means that you want to install your libraries into directories named <tt>lib64</tt>, not <tt>lib</tt>. ''/root/kdepim'' is where your source code is.
    <tt>DLIB_SUFFIX=64</tt> means that you want to install your libraries into directories named <tt>lib64</tt>, not <tt>lib</tt>. ''/root/kdepim'' is where your source code is.
    * click "Run cmake"
    * click "Run cmake"

    Revision as of 11:53, 30 June 2011


    Development/Tutorials/Using Qt Creator


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

    • how to create a new program
    • how to load an existing program

    Creating a new program

    Qt Designer is a graphical program which allows you to easily build user interfaces, using a drag n drop interface. Here is a short example how it can go, for more information read the user documentation.

    Step 0

    Call Qt Designer from within the QtCreator IDE:

    qtcreator
    
    Step 1

    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

    See also