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

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.