QAbstractButton Class

Documentación de funciones miembro

[explicit] QAbstractButton::QAbstractButton(QWidget *parent = nullptr)

Construye un botón abstracto con parent.

[virtual noexcept] QAbstractButton::~QAbstractButton()

Destruye el botón.

[slot] void QAbstractButton::animateClick()

Realiza un clic animado: el botón se pulsa inmediatamente y se suelta 100 ms después.

Si se vuelve a llamar a esta función antes de soltar el botón, se reinicia el temporizador de liberación.

Todas las señales asociadas a un clic se emiten según corresponda.

Esta función no hace nada si el botón está disabled.

Véase también click().

[override virtual protected] void QAbstractButton::changeEvent(QEvent *e)

Reimplementa: QWidget::changeEvent(QEvent *event).

[virtual protected] void QAbstractButton::checkStateSet()

Este manejador virtual es llamado cuando se utiliza setChecked(), a menos que sea llamado desde dentro de nextCheckState(). Permite a las subclases restablecer los estados intermedios de sus botones.

Véase también nextCheckState().

[slot] void QAbstractButton::click()

Realiza un clic.

Se emiten todas las señales habituales asociadas a un clic. Si el botón es controlable, se conmuta su estado.

Esta función no hace nada si el botón es disabled.

Véase también animateClick().

[signal] void QAbstractButton::clicked(bool checked = false)

Esta señal se emite cuando se activa el botón (es decir, cuando se pulsa y luego se suelta mientras el cursor del ratón está dentro del botón), cuando se teclea la tecla de acceso directo o cuando se llama a click() o animateClick(). En particular, esta señal no se emite si se llama a setDown(), setChecked() o toggle().

Si el botón es comprobable, checked es verdadero si el botón está marcado, o falso si el botón está desmarcado.

Véase también pressed(), released() y toggled().

[override virtual protected] bool QAbstractButton::event(QEvent *e)

Reimplementa: QWidget::event(QEvent *event).

[override virtual protected] void QAbstractButton::focusInEvent(QFocusEvent *e)

Reimplementa: QWidget::focusInEvent(QFocusEvent *event).

[override virtual protected] void QAbstractButton::focusOutEvent(QFocusEvent *e)

Reimplementa: QWidget::focusOutEvent(QFocusEvent *event).

QButtonGroup *QAbstractButton::group() const

Devuelve el grupo al que pertenece este botón.

Si el botón no pertenece a ningún grupo QButtonGroup, esta función devuelve nullptr.

Véase también QButtonGroup.

[virtual protected] bool QAbstractButton::hitButton(const QPoint &pos) const

Devuelve true si pos está dentro del rectángulo del botón sobre el que se puede hacer clic; en caso contrario, devuelve false.

Por defecto, el área sobre la que se puede hacer clic es todo el widget. Las subclases pueden reimplementar esta función para dar soporte a áreas clicables de diferentes formas y tamaños.

[override virtual protected] void QAbstractButton::keyPressEvent(QKeyEvent *e)

Reimplementa: QWidget::keyPressEvent(QKeyEvent *event).

[override virtual protected] void QAbstractButton::keyReleaseEvent(QKeyEvent *e)

Reimplementa: QWidget::keyReleaseEvent(QKeyEvent *event).

[override virtual protected] void QAbstractButton::mouseMoveEvent(QMouseEvent *e)

Reimplementa: QWidget::mouseMoveEvent(QMouseEvent *event).

[override virtual protected] void QAbstractButton::mousePressEvent(QMouseEvent *e)

Reimplementa: QWidget::mousePressEvent(QMouseEvent *event).

[override virtual protected] void QAbstractButton::mouseReleaseEvent(QMouseEvent *e)

Reimplementa: QWidget::mouseReleaseEvent(QMouseEvent *event).

[virtual protected] void QAbstractButton::nextCheckState()

Este manejador virtual es llamado cuando se pulsa un botón. La implementación por defecto llama a setChecked(!isChecked()) si el botón isCheckable(). Permite a las subclases implementar estados intermedios del botón.

Véase también checkStateSet().

[override pure virtual protected] void QAbstractButton::paintEvent(QPaintEvent *e)

Reimplementa: QWidget::paintEvent(QPaintEvent *event).

[signal] void QAbstractButton::pressed()

Esta señal se emite cuando se pulsa el botón.

Véase también released() y clicked().

[signal] void QAbstractButton::released()

Esta señal se emite cuando se suelta el botón.

Véase también pressed(), clicked() y toggled().

[override virtual protected] void QAbstractButton::timerEvent(QTimerEvent *e)

Reimplementa: QObject::timerEvent(QTimerEvent *event).

[slot] void QAbstractButton::toggle()

Cambia el estado de un botón seleccionable.

Véase también checked.

[signal] void QAbstractButton::toggled(bool checked)

Esta señal se emite cada vez que un botón seleccionable cambia de estado. checked es verdadero si el botón está seleccionado, o falso si el botón está deseleccionado.

Esto puede ser el resultado de una acción del usuario, de la activación de la ranura click() o porque se llama a setChecked().

Los estados de los botones en grupos de botones exclusivos se actualizan antes de que se emita esta señal. Esto significa que las ranuras pueden actuar tanto sobre la señal "off" como sobre la señal "on" emitida por los botones del grupo cuyos estados han cambiado.

Por ejemplo, una ranura que reacciona a las señales emitidas por los botones recién marcados pero que ignora las señales de los botones que han sido desmarcados puede implementarse utilizando el siguiente patrón:

void MyWidget::reactToToggle(bool checked)
{
   if (checked) {
      // Examine the new button states.
      ...
   }
}

Se pueden crear grupos de botones utilizando la clase QButtonGroup, y monitorizar las actualizaciones de los estados de los botones con la señal QButtonGroup::buttonClicked().

Véase también checked y clicked().