QRadioButton Class
El widget QRadioButton proporciona un botón de radio con una etiqueta de texto. Más...
| Cabecera: | #include <QRadioButton> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Hereda: | 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 puede ser activado (marcado) o desactivado (desmarcado). Normalmente, los botones de opción ofrecen al usuario la posibilidad de elegir entre varias opciones. En un grupo de botones de opción, sólo se puede marcar un botón de opción cada vez; si el usuario selecciona otro botón, el botón seleccionado anteriormente se desactiva.
Por defecto, los botones de opción son autoexcluyentes. Si la autoexclusión 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 necesita varios grupos de botones exclusivos para botones de radio que pertenezcan al mismo widget padre, colóquelos en QButtonGroup.
Cada vez que un botón se enciende o se apaga, emite la señal toggled(). Conéctate a esta señal si quieres desencadenar una acción cada vez que el botón cambie de estado. Utilice isChecked() para saber si un botón concreto está seleccionado.
Al igual que QPushButton, un botón de radio muestra texto y, opcionalmente, un pequeño icono. El icono se define con setIcon(). El texto puede establecerse en el constructor o con setText(). Se puede especificar un atajo de teclado precediendo el carácter preferido con un ampersand en el texto. Por ejemplo:
QRadioButton *button = new QRadioButton("Search from the &cursor", this);
En este ejemplo el atajo es Alt+c. Para más detalles, consulte la documentación de QShortcut. Para mostrar un ampersand real, utilice '&&'.
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 las funciones miembro
[explicit] QRadioButton::QRadioButton(QWidget *parent = nullptr)
Construye un botón de radio con la dirección parent, 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)
Construye un botón de radio con la cadena parent y text dadas.
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 este QRadioButton. Este método es útil para subclases cuando necesitan un QStyleOptionButton, pero no quieren rellenar toda la información ellos mismos.
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.