QCheckBox Class
Das QCheckBox-Widget stellt ein Kontrollkästchen mit einer Textbeschriftung bereit. Mehr...
| Kopfzeile: | #include <QCheckBox> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | QAbstractButton |
Eigenschaften
- tristate : bool
Öffentliche Funktionen
| QCheckBox(QWidget *parent = nullptr) | |
| QCheckBox(const QString &text, QWidget *parent = nullptr) | |
| virtual | ~QCheckBox() |
| Qt::CheckState | checkState() const |
| bool | isTristate() const |
| void | setCheckState(Qt::CheckState state) |
| void | setTristate(bool y = true) |
Neu implementierte öffentliche Funktionen
| virtual QSize | minimumSizeHint() const override |
| virtual QSize | sizeHint() const override |
Signale
(since 6.7) void | checkStateChanged(Qt::CheckState state) |
Geschützte Funktionen
| virtual void | initStyleOption(QStyleOptionButton *option) const |
Neu implementierte geschützte Funktionen
| virtual void | checkStateSet() override |
| virtual bool | event(QEvent *e) override |
| virtual bool | hitButton(const QPoint &pos) const override |
| virtual void | mouseMoveEvent(QMouseEvent *e) override |
| virtual void | nextCheckState() override |
| virtual void | paintEvent(QPaintEvent *) override |
Ausführliche Beschreibung
Ein QCheckBox ist ein Optionsfeld, das aktiviert (markiert) oder deaktiviert (nicht markiert) werden kann. QButtonGroup s werden typischerweise verwendet, um Funktionen in einer Anwendung darzustellen, die aktiviert oder deaktiviert werden können, ohne andere zu beeinflussen. Es können verschiedene Verhaltensweisen implementiert werden. Beispielsweise kann ein verwendet werden, um Kontrollkästchen logisch zu gruppieren und so exklusive Kontrollkästchen zu ermöglichen. „ QButtonGroup “ bietet jedoch keine visuelle Darstellung.
Die folgende Abbildung veranschaulicht die Unterschiede zwischen exklusiven und nicht-exklusiven Kontrollkästchen.
 |  |
Immer wenn ein Kontrollkästchen aktiviert oder deaktiviert wird, sendet es das Signal ` checkStateChanged()` aus. Verbinden Sie sich mit diesem Signal, wenn Sie bei jeder Zustandsänderung des Kontrollkästchens eine Aktion auslösen möchten. Mit ` isChecked()` können Sie abfragen, ob ein Kontrollkästchen aktiviert ist oder nicht.
Zusätzlich zu den üblichen Zuständen „aktiviert“ und „deaktiviert“ bietet QCheckBox optional einen dritten Zustand an, der „keine Änderung“ anzeigt. Dies ist nützlich, wenn Sie dem Benutzer die Möglichkeit geben möchten, ein Kontrollkästchen weder zu aktivieren noch zu deaktivieren. Wenn Sie diesen dritten Zustand benötigen, aktivieren Sie ihn mit ` setTristate()` und verwenden Sie ` checkState()`, um den aktuellen Umschaltzustand abzufragen.
Genau wie bei ` QPushButton` zeigt ein Kontrollkästchen 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 ein Und-Zeichen vorangestellt wird. Zum Beispiel:
In diesem Beispiel lautet die Tastenkombination Alt+A. Weitere Informationen finden Sie in der Dokumentation zu „ QShortcut “. Um ein echtes Und-Zeichen anzuzeigen, verwenden Sie „&&“.
Siehe auch QAbstractButton und QRadioButton.
Dokumentation zu Eigenschaften
tristate : bool
Diese Eigenschaft gibt an, ob es sich bei dem Kontrollkästchen um ein Kontrollkästchen mit drei Zuständen handelt
Der Standardwert ist „false“, d. h., das Kontrollkästchen hat nur zwei Zustände.
Zugriffsfunktionen:
| bool | isTristate() const |
| void | setTristate(bool y = true) |
Dokumentation zu den Member-Funktionen
[explicit] QCheckBox::QCheckBox(QWidget *parent = nullptr)
Erstellt ein Kontrollkästchen mit dem angegebenen ` parent`, jedoch ohne Text.
parent wird an den Konstruktor von ` QAbstractButton ` übergeben.
[explicit] QCheckBox::QCheckBox(const QString &text, QWidget *parent = nullptr)
Erstellt ein Kontrollkästchen mit den angegebenen Werten für „ parent “ und „ text “.
parent wird an den Konstruktor von ` QAbstractButton ` übergeben.
[virtual noexcept] QCheckBox::~QCheckBox()
Destruktor.
Qt::CheckState QCheckBox::checkState() const
Gibt den Auswahlstatus des Kontrollkästchens zurück. Wenn Sie keine Tristate-Unterstützung benötigen, können Sie auch die Funktion „ QAbstractButton::isChecked()“ verwenden, die einen booleschen Wert zurückgibt.
Siehe auch „ setCheckState()“ und „ Qt::CheckState “.
[signal, since 6.7] void QCheckBox::checkStateChanged(Qt::CheckState state)
Dieses Signal wird immer dann ausgelöst, wenn sich der Status des Kontrollkästchens ändert, d. h. wenn der Benutzer es aktiviert oder deaktiviert.
state enthält den neuen „ Qt::CheckState “ des Kontrollkästchens.
Diese Funktion wurde in Qt 6.7 eingeführt.
[override virtual protected] void QCheckBox::checkStateSet()
Implementiert: QAbstractButton::checkStateSet().
[override virtual protected] bool QCheckBox::event(QEvent *e)
Implementiert: ` QAbstractButton::event(QEvent *e)`.
[override virtual protected] bool QCheckBox::hitButton(const QPoint &pos) const
Implementiert: ` QAbstractButton::hitButton(const QPoint &pos) const`.
[virtual protected] void QCheckBox::initStyleOption(QStyleOptionButton *option) const
Initialisiert ` option ` mit den Werten aus dieser ` QCheckBox`. Diese Methode ist nützlich für Unterklassen, die eine ` QStyleOptionButton` benötigen, aber nicht alle Informationen selbst eingeben möchten.
Siehe auch ` QStyleOption::initFrom()`.
[override virtual] QSize QCheckBox::minimumSizeHint() const
Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::minimumSizeHint “ neu.
[override virtual protected] void QCheckBox::mouseMoveEvent(QMouseEvent *e)
Umsetzt: ` QAbstractButton::mouseMoveEvent(QMouseEvent *e)`.
[override virtual protected] void QCheckBox::nextCheckState()
Implementiert neu: QAbstractButton::nextCheckState().
[override virtual protected] void QCheckBox::paintEvent(QPaintEvent *)
Umsetzt: ` QAbstractButton::paintEvent(QPaintEvent *e)`.
void QCheckBox::setCheckState(Qt::CheckState state)
Setzt den Status des Kontrollkästchens auf „ state “. Wenn Sie keine Tristate-Unterstützung benötigen, können Sie auch die Funktion „ QAbstractButton::setChecked()“ verwenden, die einen booleschen Wert erwartet.
Siehe auch „ checkState()“ und „ Qt::CheckState “.
[override virtual] QSize QCheckBox::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.
