How to Use QPushButton

From Qt Wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

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


Using QPushButton developers can create and handle buttons. This class is easy to use and customize so it is among the most useful classes in Qt. In general the button displays text but an icon can also be displayed.

QPushButton inherits QAbstractButton which in turn inherits QWidget.


Inherited from QAbstractButton

  • void clicked(bool checked = false)
  • void pressed()
  • void released()
  • void toggled(bool checked)

Inherited from QWidget

  • void customContextMenuRequested(const QPoint &pos)

Inherited from QObject

  • void destroyed(QObject *obj = nullptr)

Basic Usage


The text of QPushButton can be set upon creation or using setText(). To get the current text of the button use text().


The icon of QPushButton can also be set upon creation. After creation the icon can be changed using setIcon() To get the current icon of the button use icon()

Set Position and Size

To set the position and the size of the button use setGeometry(). If you want just to modify the size of the button use resize()

Handle Button

QPushButton emits signals if an event occurs. To handle the button connect its appropriate signal to a slot:

connect(m_button, &QPushButton::released, this, &MainWindow::handleButton);


The following simple code snippet shows how to create and use QPushButton. It has been tested on Qt Symbian Simulator.

An instance of QPushButton is created. Signal released() is connected to slot handleButton() which changes the text and the size of the button.

To build and run the example:

  1. Create an empty folder
  2. Create a file for each of the below code snippets and add the example code to them (the name of the file should match the name above the snippet).
    • All 4 files must be in the same folder.
  3. Using command line, navigate into the folder with the 4 files.
  4. run qmake on the project file:
    • If successful it will not print any output.
    • This should create a file with the name Makefile in the folder.
  5. Build the application:
    • The application should compile without any issues.
  6. Run the application:

The above steps are for linux but can easily be followed on other systems by replacing make with the correct make call for the system.



#include <QMainWindow>
#include <QPushButton>

namespace Ui {
  class MainWindow;
class MainWindow : public QMainWindow
  explicit MainWindow(QWidget *parent = nullptr);
private slots:
  void handleButton();
  QPushButton *m_button;
#endif // MAINWINDOW_H


#include "mainwindow.h"

MainWindow::MainWindow(QWidget *parent)
  : QMainWindow(parent)
  // Create the button, make "this" the parent
  m_button = new QPushButton("My Button", this);
  // set size and location of the button
  m_button->setGeometry(QRect(QPoint(100, 100), QSize(200, 50)));
  // Connect button signal to appropriate slot
  connect(m_button, &QPushButton::released, this, &MainWindow::handleButton);
void MainWindow::handleButton()
  // change the text
  // resize button


#include "mainwindow.h"
#include <QApplication>
int main(int argc, char *argv[]) 
  QApplication app(argc, argv);
  MainWindow mainWindow;
  return app.exec();

QT       += core widgets
TARGET = PushButtonExample
SOURCES += main.cpp mainwindow.cpp  
HEADERS += mainwindow.h