Table of Content
English Български Spanish 简体中文 Ελληνικά
Русскийفارسی
How to Use QPushButton
QPushButton Overview
Using QPushButton [qt-project.org] 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 [qt-project.org] which inherits QWidget [qt-project.org].
Signals
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 = 0 )
Basic Usage
Text
The text of QPushButton can be set upon creation or using setText() [qt-project.org]. To get the current text of the button use text() [qt-project.org].
Icon
The icon of QPushButton can also be set upon creation. After creation the icon can be changed using setIcon() [qt-project.org] To get the current icon of the button use icon() [qt-project.org]
Set Position and Size
To set the position and the size of the button use setGeometry() [qt-project.org]. If you want just to modify the size of the button use resize() [qt-project.org].
Handle Button
QPushButton emits signals if an event occurs. To handle the button connect its appropriate signal to a slot:
- connect(m_button, SIGNAL(released()),this, SLOT(handleButton()));
Example
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.
mainwindow.h
- #ifndef MAINWINDOW_H
- #define MAINWINDOW_H
- #include <QtGui/QMainWindow>
- #include <QtGui/QPushButton>
- namespace Ui {
- class MainWindow;
- }
- {
- Q_OBJECT
- public:
- private slots:
- void handleButton();
- private:
- };
- #endif // MAINWINDOW_H
mainwindow.cpp
- #include "mainwindow.h"
- #include <QtCore/QCoreApplication>
- {
- // Create the button, make "this" the parent
- // set size and location of the button
- // Connect button signal to appropriate slot
- connect(m_button, SIGNAL(released()), this, SLOT(handleButton()));
- }
- void MainWindow::handleButton()
- {
- // change the text
- m_button->setText("Example");
- // resize button
- m_button->resize(100,100);
- }
main.cpp
- #include "mainwindow.h"
- #include <QtGui/QApplication>
- int main(int argc, char *argv[])
- {
- MainWindow mainWindow;
- mainWindow.showMaximized();
- return app.exec();
- }
See also
Qt Buttons [developer.qt.nokia.com]
Basic Qt Programming Tutorial [developer.qt.nokia.com]
