En esta página

QRadioButton Class

El widget QRadioButton ofrece un botón de opción con una etiqueta de texto. Más...

Encabezado: #include <QRadioButton>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredan: QAbstractButton

Funciones públicas

QRadioButton(QWidget *parent = nullptr)
QRadioButton(const QString &text, QWidget *parent = nullptr)
virtual ~QRadioButton()

Funciones públicas reimplementadas

virtual QSize minimumSizeHint() const override
virtual QSize sizeHint() const override

Funciones protegidas

virtual void initStyleOption(QStyleOptionButton *option) const

Funciones protegidas reimplementadas

virtual bool event(QEvent *e) override
virtual bool hitButton(const QPoint &pos) const override
virtual void mouseMoveEvent(QMouseEvent *e) override
virtual void paintEvent(QPaintEvent *) override

Descripción detallada

Dos botones de opción que representan dos opciones

Un QRadioButton es un botón de opción que se puede activar (marcar) o desactivar (desmarcar). Los botones de opción suelen ofrecer al usuario una elección del tipo «una de varias». En un grupo de botones de opción, solo se puede marcar un botón de opción a la vez; si el usuario selecciona otro botón, el botón seleccionado anteriormente se desactiva.

Los botones de opción son «autoExclusive» por defecto. Si la opción «auto-exclusive» está activada, los botones de opción que pertenecen al mismo widget padre se comportan como si formaran parte del mismo grupo de botones exclusivos. Si necesitas varios grupos de botones exclusivos para botones de opción que pertenecen al mismo widget padre, colócalos dentro de un ` QButtonGroup`.

Cada vez que se activa o desactiva un botón, este emite la señal « toggled()». Conéctate a esta señal si deseas activar una acción cada vez que el botón cambie de estado. Utiliza « isChecked()» para comprobar si un botón concreto está seleccionado.

Al igual que QPushButton, un botón de opción muestra texto y, opcionalmente, un pequeño icono. El icono se establece con setIcon(). El texto se puede establecer en el constructor o con setText(). Se puede especificar una tecla de acceso rápido anteponiendo un símbolo «&» al carácter deseado en el texto. Por ejemplo:

QRadioButton *button = new QRadioButton("Search from the &cursor", this);

En este ejemplo, el atajo es Alt+c. Consulta la documentación de QShortcut para obtener más detalles. Para mostrar un símbolo «&» real, utiliza «&&».

Miembros heredados importantes: text(), setText(), text(), setDown(), isDown(), autoRepeat(), group(), setAutoRepeat(), toggle(), pressed(), released(), clicked() y toggled().

Véase también QPushButton, QToolButton y QCheckBox.

Documentación de funciones miembro

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

Crea un botón de opción con el argumento « parent » especificado, pero sin texto ni mapa de píxeles.

El argumento ` parent ` se pasa al constructor ` QAbstractButton `.

[explicit] QRadioButton::QRadioButton(const QString &text, QWidget *parent = nullptr)

Crea un botón de opción con las cadenas « parent » y « text » indicadas.

El argumento parent se pasa al constructor QAbstractButton.

[virtual noexcept] QRadioButton::~QRadioButton()

Destructor.

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

Reimplementa: QAbstractButton::event(QEvent *e).

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

Reimplementa: ` QAbstractButton::hitButton(const QPoint &pos) const`.

[virtual protected] void QRadioButton::initStyleOption(QStyleOptionButton *option) const

Inicializa ` option ` con los valores de esta página: QRadioButton. Este método resulta útil para las subclases cuando necesitan un ` QStyleOptionButton`, pero no quieren introducir toda la información ellas mismas.

Véase también QStyleOption::initFrom().

[override virtual] QSize QRadioButton::minimumSizeHint() const

Reimplementa una función de acceso para la propiedad: QWidget::minimumSizeHint.

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

Reimplementa: QAbstractButton::mouseMoveEvent(QMouseEvent *e).

[override virtual protected] void QRadioButton::paintEvent(QPaintEvent *)

Reimplementa: QAbstractButton::paintEvent(QPaintEvent *e).

[override virtual] QSize QRadioButton::sizeHint() const

Reimplementa una función de acceso para la propiedad: QWidget::sizeHint.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.