QRadioButton Class
Das QRadioButton-Widget stellt ein Optionsfeld mit einer Textbeschriftung bereit. Mehr...
| Kopfzeile: | #include <QRadioButton> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | QAbstractButton |
Öffentliche Funktionen
| QRadioButton(QWidget *parent = nullptr) | |
| QRadioButton(const QString &text, QWidget *parent = nullptr) | |
| virtual | ~QRadioButton() |
Neu implementierte öffentliche Funktionen
| virtual QSize | minimumSizeHint() const override |
| virtual QSize | sizeHint() const override |
Geschützte Funktionen
| virtual void | initStyleOption(QStyleOptionButton *option) const |
Neu implementierte geschützte Funktionen
| 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 |
Ausführliche Beschreibung
Ein QRadioButton ist ein Optionsfeld, das aktiviert (markiert) oder deaktiviert (nicht markiert) werden kann. Optionsfelder bieten dem Benutzer in der Regel eine Auswahl aus mehreren Optionen. In einer Gruppe von Optionsfeldern kann jeweils nur ein Optionsfeld markiert sein; wählt der Benutzer ein anderes Optionsfeld aus, wird das zuvor ausgewählte Optionsfeld deaktiviert.
Optionsschaltflächen sind standardmäßig „autoExclusive“. Ist „autoExclusive“ aktiviert, verhalten sich Optionsschaltflächen, die zum selben übergeordneten Widget gehören, so, als wären sie Teil derselben exklusiven Schaltflächengruppe. Wenn Sie mehrere exklusive Schaltflächengruppen für Optionsschaltflächen benötigen, die zum selben übergeordneten Widget gehören, fügen Sie diese in ein „ QButtonGroup “ ein.
Immer wenn ein Radiobutton aktiviert oder deaktiviert wird, sendet er das Signal „ toggled()“ aus. Verbinden Sie sich mit diesem Signal, wenn Sie bei jeder Zustandsänderung des Radiobuttons eine Aktion auslösen möchten. Verwenden Sie „ isChecked()“, um zu prüfen, ob ein bestimmter Radiobutton ausgewählt ist.
Genau wie „ QPushButton “ zeigt ein Optionsfeld Text und optional ein kleines Symbol an. Das Symbol wird mit „ setIcon()“ festgelegt. Der Text kann im Konstruktor oder mit „ setText()“ festgelegt werden. Eine Tastenkombination kann festgelegt werden, indem dem gewünschten Zeichen im Text ein Und-Zeichen vorangestellt wird. Zum Beispiel:
QRadioButton *button = new QRadioButton("Search from the &cursor", this);In diesem Beispiel lautet die Tastenkombination Alt+c. Weitere Informationen finden Sie in der Dokumentation zu „ QShortcut “. Um ein echtes Und-Zeichen anzuzeigen, verwenden Sie „&&“.
Wichtige geerbte Mitglieder: ` text()`, ` setText()`, ` text()`, ` setDown()`, ` isDown()`, ` autoRepeat()`, ` group()`, ` setAutoRepeat()`, ` toggle()`, ` pressed()`, ` released()`, ` clicked()` und ` toggled()`.
Siehe auch QPushButton, QToolButton und QCheckBox.
Dokumentation zu den Member-Funktionen
[explicit] QRadioButton::QRadioButton(QWidget *parent = nullptr)
Erstellt ein Optionsfeld mit dem angegebenen ` parent`, jedoch ohne Text oder Pixmap.
Das Argument ` parent ` wird an den Konstruktor von ` QAbstractButton ` übergeben.
[explicit] QRadioButton::QRadioButton(const QString &text, QWidget *parent = nullptr)
Erstellt ein Optionsfeld mit den angegebenen Zeichenfolgen „ parent “ und „ text “.
Das Argument „ parent “ wird an den Konstruktor von „ QAbstractButton “ übergeben.
[virtual noexcept] QRadioButton::~QRadioButton()
Destruktor.
[override virtual protected] bool QRadioButton::event(QEvent *e)
Implementiert: ` QAbstractButton::event(QEvent *e)`.
[override virtual protected] bool QRadioButton::hitButton(const QPoint &pos) const
Implementiert neu: ` QAbstractButton::hitButton(const QPoint &pos) const`.
[virtual protected] void QRadioButton::initStyleOption(QStyleOptionButton *option) const
Initialisieren Sie ` option ` mit den Werten aus dieser Datei: QRadioButton. Diese Methode ist für Unterklassen nützlich, wenn diese ein ` QStyleOptionButton` benötigen, aber nicht alle Informationen selbst eingeben möchten.
Siehe auch ` QStyleOption::initFrom()`.
[override virtual] QSize QRadioButton::minimumSizeHint() const
Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::minimumSizeHint “ neu.
[override virtual protected] void QRadioButton::mouseMoveEvent(QMouseEvent *e)
Implementiert: ` QAbstractButton::mouseMoveEvent(QMouseEvent *e)`.
[override virtual protected] void QRadioButton::paintEvent(QPaintEvent *)
Umsetzt: ` QAbstractButton::paintEvent(QPaintEvent *e)`.
[override virtual] QSize QRadioButton::sizeHint() const
Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::sizeHint “ neu.
© 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.
