Basic Qt Programming Tutorial: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
 
(<pre> → <syntaxhighlight lang="cpp">)
 
(18 intermediate revisions by 6 users not shown)
Line 1: Line 1:
'''English''' [[Basic Qt Programming Tutorial SimplifiedChinese|简体中文]] [[Basic Qt Programming Tutorial Persian|فارسی]] [[Temel Qt Programlama Egitimi|Türkçe]] [[Basic Qt Programming Tutorial Spanish|Español]]
[[Category:HowTo]]


=Introduction=
{{LangSwitch}}


This tutorial will explain in detail how to take your first steps in programming with Qt using the Qt Creator integrated development environment (<span class="caps">IDE</span>).
== Introduction ==


If you want to learn how to make powerful <span class="caps">GUI</span>s with all the latest fancy technologies, this is not the tutorial for you. This is firmly intended as a gentle introduction to help beginners get up and running without scaring them.
This tutorial will explain in detail how to take your first steps in programming with Qt using the Qt Creator integrated development environment (IDE).


We will begin by creating a new Qt-based project and modifying the generated code to show a very simple graphical user interface (<span class="caps">GUI</span>). Once our basic application project is in place and running, we will go back and modify it to do some slightly useful things.
If you want to learn how to make powerful GUIs with all the latest fancy technologies, this is not the tutorial for you. This is firmly intended as a gentle introduction to help beginners get up and running without scaring them.
 
We will begin by creating a new Qt-based project and modifying the generated code to show a very simple graphical user interface (GUI). Once our basic application project is in place and running, we will go back and modify it to do some slightly useful things.


We will start off simple and build up in complexity as you get more familiar with the widgets and other facilities at your disposal.
We will start off simple and build up in complexity as you get more familiar with the widgets and other facilities at your disposal.


So, grab yourself a copy of the Qt <span class="caps">SDK</span> or if you are on Linux the system-provided copy of Qt and a compiler and let’s get started!
So, let's get started!
 
== Before you start: Download and install Qt and Qt Creator ==
Grab yourself a copy of the Qt SDK or if you are on Linux the system-provided copy of Qt and a compiler.
 
If you are starting off you might want to consider the open source LGPL version.
 
The open source downloads can be found on the [http://www.qt.io/ qt.io] website [http://www.qt.io/download-open-source/ here].
 
For commercial use consider getting a Qt Commercial [http://www.qt.io/qt-licensing-terms/ license]. 
 
== Baby steps: Creating a new project ==
 
Let's try making a trivial application that has a single window that shows a QLabel and a QLineEdit. To do this follow these simple steps:
 
Start up Qt Creator:
 
[[File:Qtcreator-001.png|600px]]
 
Go to ''File'' &mdash; ''New File or Project'' menu entry


==Baby steps: Creating a new project==
Choose Qt Gui Application and choose a name for it:


Let’s try making a trivial application that has a single window that shows a QLabel and a QLineEdit. To do this follow these simple steps:
[[File:Qtcreator-002.png|600px]]


# Start up Qt Creator.<br />[http://gallery.theharmers.co.uk/picture.php?/22/category/7 [[Image:TN-20110503152033-f24040e3.jpg|Start Qt-Creator]]] ''[gallery.theharmers.co.uk]''
Enter a project name, "qt-tutorial-01", say.
# Go to File-&gt;“New File or Project…” menu entry.
 
# Choose Qt Gui Application and choose a name for it.<br />[http://gallery.theharmers.co.uk/picture.php?/23/category/7 [[Image:TN-20110503152034-ea9bb58a.jpg|Select project type]]] ''[gallery.theharmers.co.uk]''
[[File:Qtcreator-003.png|600px]]
# Enter a project name, “qt-tutorial-01”, say.<br />[http://gallery.theharmers.co.uk/picture.php?/24/category/7 [[Image:TN-20110503152034-8dabd337.jpg|Choose project name]]] ''[gallery.theharmers.co.uk]''
 
# Select one or more versions of Qt to target. A desktop build is fine for this tutorial.<br />[http://gallery.theharmers.co.uk/picture.php?/25/category/7 [[Image:TN-20110503152034-35f9e7cb.jpg|Choose Qt build to target]]] ''[gallery.theharmers.co.uk]''
Select one or more versions of Qt to target. A desktop build is fine for this tutorial.
# Select the base class to be QWidget (leave the class name as Widget which is the default).<br />[http://gallery.theharmers.co.uk/picture.php?/26/category/7 [[Image:TN-20110503152034-26f92911.jpg|Select project generation options]]] ''[gallery.theharmers.co.uk]''
 
# Check project creation options on summary and click “Finish”.<br />[http://gallery.theharmers.co.uk/picture.php?/27/category/7 [[Image:TN-20110503152034-95ce9f30.jpg|Check project summary]]] ''[gallery.theharmers.co.uk]''
[[File:Qtcreator-004.png|600px]]
 
Select the base class to be QWidget (leave the class name as Widget which is the default).
 
[[File:Qtcreator-005.png|600px]]
 
Check project creation options on summary and click "Finish".
 
[[File:Qtcreator-006.png|600px]]


The above will create you a simple project consisting of four files:
The above will create you a simple project consisting of four files:
Line 32: Line 61:
* widget.ui
* widget.ui


==Learning to crawl: Editing the project files==
== Learning to crawl: Editing the project files ==


We will edit the widget.ui file first so:
We will edit the widget.ui file first so:


# Click on that and designer will switch to design mode and open up the file. You should see a blank widget. Now do this:<br />[http://gallery.theharmers.co.uk/picture.php?/28/category/7 [[Image:TN-20110503154826-af1ea190.jpg|Open designer]]] ''[gallery.theharmers.co.uk]''
Click on that and designer will switch to design mode and open up the file. You should see a blank widget. Now do this:
# Using the toolbox on the left, drag a Label onto the widget form<br />[http://gallery.theharmers.co.uk/picture.php?/29/category/7 [[Image:TN-20110503154826-661b1ceb.jpg|Add label]]] ''[gallery.theharmers.co.uk]''
 
# Do similarly for a Line Edit and place it to the right of the Label. The exact position is not important.<br />[http://gallery.theharmers.co.uk/picture.php?/30/category/7 [[Image:TN-20110503154826-8c16787b.jpg|Add line edit]]] ''[gallery.theharmers.co.uk]''
[[File:Qtcreator-007.png|600px]]
# Click on the widget background so that both of your new widgets (the label and line edit) get deselected.<br />[http://gallery.theharmers.co.uk/picture.php?/31/category/7 [[Image:TN-20110503154826-5084f96c.jpg|Select parent widget]]] ''[gallery.theharmers.co.uk]''
 
# In the toolbar at the top click on the “Lay out Horizontally” button or press Ctrl-H to add all widgets to a horizontal layout. The layout will take care of resizing your widgets for you if the parent widget’s size changes.<br />[http://gallery.theharmers.co.uk/picture.php?/32/category/7 [[Image:TN-20110503154826-01e7e207.jpg|Apply horizontal layout]]] ''[gallery.theharmers.co.uk]''
Using the toolbox on the left, drag a Label onto the widget form
# Double click on the Label and it will switch to edit mode. Change the text to “My name is:”<br />[http://gallery.theharmers.co.uk/picture.php?/33/category/7 [[Image:TN-20110503154826-4e8b7939.jpg|Change label text]]] ''[gallery.theharmers.co.uk]''
 
# Press Ctrl-S to save the form.
[[File:Qtcreator-008.png|600px]]
# Click on the Edit mode button in the left hand panel of creator to switch back to the text editor. You will probably see the raw xml content of the UI file at this point. Just close it we are done with it for now.<br />[http://gallery.theharmers.co.uk/picture.php?/34/category/7 [[Image:TN-20110503154826-abad6378.jpg|Switch to Edit mode]]] ''[gallery.theharmers.co.uk]''
 
Do similarly for a Line Edit and place it to the right of the Label. The exact position is not important.
 
[[File:Qtcreator-009.png|600px]]
 
Click on the widget background so that both of your new widgets (the label and line edit) get deselected.
 
[[File:Qtcreator-010.png|600px]]
 
In the toolbar at the top click on the "Lay out Horizontally" button or press Ctrl-H to add all widgets to a horizontal layout. The layout will take care of resizing your widgets for you if the parent widget's size changes.
 
[[File:Qtcreator-011.png|600px]]
 
Double click on the Label and it will switch to edit mode. Change the text to "My name is:"
 
[[File:Qtcreator-012.png|600px]]
 
Press Ctrl-S to save the form.
 
Click on the Edit mode button in the left hand panel of creator to switch back to the text editor. You will probably see the raw xml content of the UI file at this point. Just close it we are done with it for now.
 
[[File:Qtcreator-013.png|600px]]


Now open up the widget.h file and edit it so that it looks like this:
Now open up the widget.h file and edit it so that it looks like this:
<syntaxhighlight lang="cpp">
#ifndef WIDGET_H
#define WIDGET_H
#include <QWidget>
namespace Ui {
  class Widget;
}
class Widget : public QWidget
{
  Q_OBJECT
public:
  explicit Widget(QWidget *parent = 0);
  ~Widget();
void setName(const QString &name);
  QString name() const;
private:
  Ui::Widget *ui;
};
#endif // WIDGET_H
</syntaxhighlight>


Now edit the corresponding .cpp file to look like this:
Now edit the corresponding .cpp file to look like this:
<syntaxhighlight lang="cpp">
#include "widget.h"
#include "ui_widget.h"
Widget::Widget(QWidget *parent) :
  QWidget(parent),
  ui(new Ui::Widget)
{
  ui->setupUi(this);
}
Widget::~Widget()
{
  delete ui;
}
void Widget::setName(const QString &name)
{
  ui->lineEdit->setText(name);
}
QString Widget::name() const
{
  return ui->lineEdit->text();
}
</syntaxhighlight>


Finally edit main.cpp to this:
Finally edit main.cpp to this:


==Up and running: Building and running the application==
<syntaxhighlight lang="cpp">
 
#include <QApplication>
Now build (Hammer icon in lower left or default shortcut of Ctrl-Shift-B) and run the application (green “play” icon in lower left corner). You will see some compiler messages go past in the “Compile Output” panel at the bottom whilst building.<br />[http://gallery.theharmers.co.uk/picture.php?/35/category/7 [[Image:TN-20110503160137-3e61f249.jpg|Compiling the project]]] ''[gallery.theharmers.co.uk]''
#include "widget.h"
int main(int argc, char *argv[])
{
  QApplication a(argc, argv);
  Widget w;
  w.setName("Slim Shady");
  w.show();
  return a.exec();
}
</syntaxhighlight>


This is what the application looks like when it is executed:<br />[http://gallery.theharmers.co.uk/picture.php?/36/category/7 [[Image:TN-20110503160137-aac48922.jpg|The running application]]] ''[gallery.theharmers.co.uk]''
== Up and running: Building and running the application ==


As you can see the main() function is very simple. All we do is create a [http://doc.qt.nokia.com/latest/qapplication.html QApplication] ''[doc.qt.nokia.com]'' and then a Widget (this is our custom widget that we layed out in designer and added custom behaviour to in code with the name() and setName() functions).
Now build (Hammer icon in lower left or default shortcut of Ctrl-Shift-B) and run the application (green "play" icon in lower left corner). You will see some compiler messages go past in the "Compile Output" panel at the bottom whilst building.


We then call our custom setName function on the widget. This in turn gets a pointer to the [http://doc.qt.nokia.com/latest/qlineedit.html QLineEdit] ''[doc.qt.nokia.com]'' widget that we placed on the form and calls the [http://doc.qt.nokia.com/latest/qlineedit.html#text-prop setText()] ''[doc.qt.nokia.com]''() function of QLineEdit.
[[File:Qtcreator-014.png|600px]]


Finally we show the widget and enter the event loop by calling a.exec().
This is what the application looks like when it is executed:


Once you understand how this simple app works then you can start adding some more bells and whistles like signal/slot connections.
[[File:Qtcreator-015.png|600px]]


==See also==
As you can see the <tt>main()</tt> function is very simple. All we do is create a {{DocLink|QApplication}} and then a Widget (this is our custom widget that we layed out in designer and added custom behaviour to in code with the <tt>name()</tt> and <tt>setName()</tt> functions).


* [[Introduction to Qt Quick for Cpp developers|“Introduction to Qt Quick for C++ Developers”]]<br />''Note:'' The paper above is deprecated. Its content is now part of [[Introduction to Qt Quick|“Introduction to Qt Quick”]].
We then just call our custom setName function on the widget. This in turn gets a pointer to the {{DocLink|QLineEdit}} widget that we placed on the form and calls the {{DocLink|QLineEdit|text-prop|setText()}} function of QLineEdit.
* [[How to Use QPushButton|“How to Use QPushButton”]]
* [[How-to-use-signals-and-slots|“How to use signals and slots”]]


===Categories:===
Finally we show the widget and enter the event loop by calling <tt>a.exec()</tt>.


* [[:Category:Developing with Qt|Developing_with_Qt]]
Once you understand how this simple app works then you can start adding some more bells and whistles like signal/slot connections.
** [[:Category:Developing with Qt::General|General]]
* [[:Category:HowTo|HowTo]]
* [[:Category:Tutorial|Tutorial]]

Latest revision as of 23:31, 22 November 2022


En Ar Bg De El Es Fa Fi Fr Hi Hu It Ja Kn Ko Ms Nl Pl Pt Ru Sq Th Tr Uk Zh

Introduction

This tutorial will explain in detail how to take your first steps in programming with Qt using the Qt Creator integrated development environment (IDE).

If you want to learn how to make powerful GUIs with all the latest fancy technologies, this is not the tutorial for you. This is firmly intended as a gentle introduction to help beginners get up and running without scaring them.

We will begin by creating a new Qt-based project and modifying the generated code to show a very simple graphical user interface (GUI). Once our basic application project is in place and running, we will go back and modify it to do some slightly useful things.

We will start off simple and build up in complexity as you get more familiar with the widgets and other facilities at your disposal.

So, let's get started!

Before you start: Download and install Qt and Qt Creator

Grab yourself a copy of the Qt SDK or if you are on Linux the system-provided copy of Qt and a compiler.

If you are starting off you might want to consider the open source LGPL version.

The open source downloads can be found on the qt.io website here.

For commercial use consider getting a Qt Commercial license.

Baby steps: Creating a new project

Let's try making a trivial application that has a single window that shows a QLabel and a QLineEdit. To do this follow these simple steps:

Start up Qt Creator:

Qtcreator-001.png

Go to FileNew File or Project menu entry

Choose Qt Gui Application and choose a name for it:

Qtcreator-002.png

Enter a project name, "qt-tutorial-01", say.

Qtcreator-003.png

Select one or more versions of Qt to target. A desktop build is fine for this tutorial.

Qtcreator-004.png

Select the base class to be QWidget (leave the class name as Widget which is the default).

Qtcreator-005.png

Check project creation options on summary and click "Finish".

Qtcreator-006.png

The above will create you a simple project consisting of four files:

  • main.cpp
  • widget.h
  • widget.cpp
  • widget.ui

Learning to crawl: Editing the project files

We will edit the widget.ui file first so:

Click on that and designer will switch to design mode and open up the file. You should see a blank widget. Now do this:

Qtcreator-007.png

Using the toolbox on the left, drag a Label onto the widget form

Qtcreator-008.png

Do similarly for a Line Edit and place it to the right of the Label. The exact position is not important.

Qtcreator-009.png

Click on the widget background so that both of your new widgets (the label and line edit) get deselected.

Qtcreator-010.png

In the toolbar at the top click on the "Lay out Horizontally" button or press Ctrl-H to add all widgets to a horizontal layout. The layout will take care of resizing your widgets for you if the parent widget's size changes.

Qtcreator-011.png

Double click on the Label and it will switch to edit mode. Change the text to "My name is:"

Qtcreator-012.png

Press Ctrl-S to save the form.

Click on the Edit mode button in the left hand panel of creator to switch back to the text editor. You will probably see the raw xml content of the UI file at this point. Just close it we are done with it for now.

Qtcreator-013.png

Now open up the widget.h file and edit it so that it looks like this:

 #ifndef WIDGET_H
 #define WIDGET_H 
 
 #include <QWidget>
 
 namespace Ui {
  class Widget;
 }
 
 class Widget : public QWidget
 {
  Q_OBJECT
 
 public:
  explicit Widget(QWidget *parent = 0);
  ~Widget();
 
 void setName(const QString &name);
  QString name() const;
 
 private:
  Ui::Widget *ui;
 };
 
 #endif // WIDGET_H

Now edit the corresponding .cpp file to look like this:

 #include "widget.h"
 #include "ui_widget.h"
 
 Widget::Widget(QWidget *parent) :
  QWidget(parent),
  ui(new Ui::Widget)
 {
  ui->setupUi(this);
 }
 
 Widget::~Widget()
 {
  delete ui;
 }
 
 void Widget::setName(const QString &name)
 {
  ui->lineEdit->setText(name);
 }
 
 QString Widget::name() const
 {
  return ui->lineEdit->text();
 }

Finally edit main.cpp to this:

 #include <QApplication>
 #include "widget.h" 
 
 int main(int argc, char *argv[])
 {
  QApplication a(argc, argv);
  Widget w;
 
  w.setName("Slim Shady");
 
  w.show();
 
  return a.exec();
 }

Up and running: Building and running the application

Now build (Hammer icon in lower left or default shortcut of Ctrl-Shift-B) and run the application (green "play" icon in lower left corner). You will see some compiler messages go past in the "Compile Output" panel at the bottom whilst building.

Qtcreator-014.png

This is what the application looks like when it is executed:

Qtcreator-015.png

As you can see the main() function is very simple. All we do is create a QApplication and then a Widget (this is our custom widget that we layed out in designer and added custom behaviour to in code with the name() and setName() functions).

We then just call our custom setName function on the widget. This in turn gets a pointer to the QLineEdit widget that we placed on the form and calls the setText() function of QLineEdit.

Finally we show the widget and enter the event loop by calling a.exec().

Once you understand how this simple app works then you can start adding some more bells and whistles like signal/slot connections.