How to Use QPushButton/es

[toc align_right="yes" depth="3"]

Spanish English Български 简体中文 Русский

Como usar QPushButton

Información general acerca de QPushButton

Usando "QPushButton":http://doc.qt.io/qt-5.0/qtwidgets/qpushbutton.html los desarrolladores podrán crear y manejar botones. Esta clases es fácil de usar y personalizar, por lo que es una de las clases mas útiles de Qt. Por lo general un botos muestra un texto, pero también es posible que muestre un icono.

QPushButton hereda de "QAbstractButton":http://doc.qt.io/qt-5.0/qtwidgets/qabstractbutton.html que hereda de "QWidget":http://doc.qt.io/qt-5.0/qtwidgets/qwidget.html.

Señales (Signals)

Hereda de QAbstractButton

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

Hereda de QWidget

• void customContextMenuRequested ( const QPoint & pos )

Hereda de QObject

• void destroyed ( QObject * obj = 0 )

Uso básico

Texto

Se puede establecer el texto de un QPushButton en su creación o usando "setText()":http://doc.qt.io/qt-5.0/qtwidgets/qabstractbutton.html#text-prop. Para obtener el texto usado actualmente por el botón usamos "text()":http://doc.qt.io/qt-5.0/qtwidgets/qabstractbutton.html#text-prop.

Icono

El icono de un QPushButton al igual que el texto del mismo se puede establecer en su creación. Luego también es posible cambiarlo usando "setIcon()":http://doc.qt.io/qt-5.0/qtwidgets/qabstractbutton.html#icon-prop Para obtener el icono en uso actualmente use "icon()":http://doc.qt.io/qt-5.0/qtwidgets/qabstractbutton.html#icon-prop

Establecer posición y tamaño

Para establecer la posición y el tamaño de un botón use "setGeometry()":http://doc.qt.io/qt-5.0/qtwidgets/qwidget.html#geometry-prop. Si lo que busca es modificar el tamaño del botón use "resize()":http://doc.qt.io/qt-5.0/qtwidgets/qwidget.html#size-prop.

Manejando el botón

QPushButton emite una señal si un evento ocurre. Para manejar el botón conecte la señal apropiada a el slot:

connect(m_pButton, SIGNAL (released()),this, SLOT (handleButton()));<code>

== Ejemplo ==

El siguiente fragmento de código muestra como crear y usar un QPushButton. El mismo a sido probado en Qt Symbian Simulator

Una instancia de QPushButton es creada. La señal '''released()''' es conectada al slot '''handleButton()''' que cambia el texto y el tamaño del botón.

=== mainwindow.h ===

1. ifndef MAINWINDOW_H
2. define MAINWINDOW_H

1. include <QtGui/QMainWindow>
2. include <QPushButton>

namespace Ui {

class MainWindow;

}

class MainWindow : public QMainWindow {

Q_OBJECT

public:

explicit MainWindow(QWidget parent = 0);

virtual ~MainWindow();

private slots:

void handleButton();

private:

QPushButton m_pButton;

};

1. endif // MAINWINDOW_H

=== mainwindow.cpp ===

1. include "mainwindow.h"

1. include <QtCore/QCoreApplication>

MainWindow::MainWindow(QWidget *parent)

: QMainWindow(parent)

{

//Create the button
m_pButton = new QPushButton("My Button", this);
//set size and location of the button
m_pButton->setGeometry(QRect( QPoint(100, 100),
QSize(200, 50) ));

//Connect button signal to appropriate slot

connect(m_pButton, SIGNAL (released()),this, SLOT (handleButton()));

}

void MainWindow::handleButton() {

//change the text
m_pButton->setText("Example");
//resize button
m_pButton->resize(100,100);

}

MainWindow::~MainWindow() {

}

=== main.cpp ===

1. include "mainwindow.h"

1. include <QtGui/QApplication>

int main(int argc, char *argv[]) {

QApplication app(argc, argv);

MainWindow mainWindow;

mainWindow.showMaximized();
return app.exec();

}

Mas información

"Botones Qt":http://developer.qt.nokia.com/wiki/Qt_Buttons_Spanish