QGroupBox Class
Das QGroupBox-Widget stellt einen Gruppenrahmen mit einem Titel bereit. Mehr...
| Überschrift: | #include <QGroupBox> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | QWidget |
Eigenschaften
Öffentliche Funktionen
| QGroupBox(QWidget *parent = nullptr) | |
| QGroupBox(const QString &title, QWidget *parent = nullptr) | |
| virtual | ~QGroupBox() |
| Qt::Alignment | alignment() const |
| bool | isCheckable() const |
| bool | isChecked() const |
| bool | isFlat() const |
| void | setAlignment(int alignment) |
| void | setCheckable(bool checkable) |
| void | setFlat(bool flat) |
| void | setTitle(const QString &title) |
| QString | title() const |
Neu implementierte öffentliche Funktionen
| virtual QSize | minimumSizeHint() const override |
Öffentliche Slots
| void | setChecked(bool checked) |
Signale
Geschützte Funktionen
| virtual void | initStyleOption(QStyleOptionGroupBox *option) const |
Neu implementierte geschützte Funktionen
| virtual void | changeEvent(QEvent *ev) override |
| virtual void | childEvent(QChildEvent *c) override |
| virtual bool | event(QEvent *e) override |
| virtual void | focusInEvent(QFocusEvent *fe) override |
| virtual void | mouseMoveEvent(QMouseEvent *event) override |
| virtual void | mousePressEvent(QMouseEvent *event) override |
| virtual void | mouseReleaseEvent(QMouseEvent *event) override |
| virtual void | paintEvent(QPaintEvent *event) override |
| virtual void | resizeEvent(QResizeEvent *e) override |
Ausführliche Beschreibung
Eine Gruppenbox bietet einen Rahmen, einen Titel oben, eine Tastenkombination und zeigt verschiedene andere Widgets in ihrem Inneren an. Die Tastenkombination verschiebt den Tastaturfokus auf eines der untergeordneten Widgets der Gruppenbox.
Mit QGroupBox können Sie außerdem die Eigenschaft „ title “ (normalerweise im Konstruktor festgelegt) und die Eigenschaft „ alignment “ des Titels festlegen. Gruppenfelder können als „ checkable “ markiert werden. Untergeordnete Widgets in ankreuzbaren Gruppenfeldern werden je nachdem, ob das Gruppenfeld „ checked “ ist oder nicht, aktiviert oder deaktiviert.
Sie können den Platzbedarf einer Gruppenbox minimieren, indem Sie die Eigenschaft „ flat “ aktivieren. In den meisten „ styles “ führt die Aktivierung dieser Eigenschaft dazu, dass die linken, rechten und unteren Ränder des Rahmens entfernt werden.
QGroupBox ordnet die untergeordneten Widgets nicht automatisch an (bei denen es sich häufig um „ QCheckBox“ oder „ QRadioButton“ handelt, die aber beliebige Widgets sein können). Das folgende Beispiel zeigt, wie wir eine QGroupBox mit einem Layout einrichten können:
QGroupBox *groupBox = new QGroupBox(tr("Group Box with Layout"));
QRadioButton *radio1 = new QRadioButton(tr("&Radio button 1"));
QRadioButton *radio2 = new QRadioButton(tr("R&adio button 2"));
QRadioButton *radio3 = new QRadioButton(tr("Ra&dio button 3"));
radio1->setChecked(true);
QVBoxLayout *vbox = new QVBoxLayout;
vbox->addWidget(radio1);
vbox->addWidget(radio2);
vbox->addWidget(radio3);
vbox->addStretch(1);
groupBox->setLayout(vbox);Siehe auch QButtonGroup.
Dokumentation zu den Eigenschaften
alignment : Qt::Alignment
Diese Eigenschaft legt die Ausrichtung des Titels des Gruppenfelds fest.
Bei den meisten Stilen wird der Titel oben im Rahmen platziert. Die horizontale Ausrichtung des Titels kann mithilfe einzelner Werte aus der folgenden Liste festgelegt werden:
- Qt::AlignLeft Richtet den Titeltext am linken Rand des Gruppenfelds aus.
- Qt::AlignRight Richtet den Titeltext am rechten Rand des Gruppenfelds aus.
- Qt::AlignHCenter Richtet den Titeltext an der horizontalen Mitte des Gruppenfelds aus.
Die Standardausrichtung ist „ Qt::AlignLeft “.
Access-Funktionen:
| Qt::Alignment | alignment() const |
| void | setAlignment(int alignment) |
Siehe auch „ Qt::Alignment “.
checkable : bool
Diese Eigenschaft gibt an, ob das Gruppenfeld ein Kontrollkästchen in seinem Titel enthält
Ist diese Eigenschaft auf „ true “ gesetzt, zeigt das Gruppenfeld seinen Titel mithilfe eines Kontrollkästchens anstelle einer gewöhnlichen Beschriftung an. Ist das Kontrollkästchen aktiviert, sind die untergeordneten Elemente des Gruppenfelds aktiviert; andernfalls sind sie deaktiviert und nicht zugänglich.
Standardmäßig sind Gruppenfelder nicht aktivierbar.
Wenn diese Eigenschaft für eine Gruppenbox aktiviert ist, wird das Kontrollkästchen zunächst aktiviert, um sicherzustellen, dass deren Inhalte aktiviert sind.
Zugriffsfunktionen:
| bool | isCheckable() const |
| void | setCheckable(bool checkable) |
Siehe auch „ checked “.
checked : bool
Diese Eigenschaft gibt an, ob das Kontrollkästchen der Gruppenbox aktiviert ist
Wenn das Gruppenfeld aktivierbar ist, wird es mit einem Kontrollkästchen angezeigt. Ist das Kontrollkästchen aktiviert, sind die untergeordneten Elemente des Gruppenfelds aktiviert; andernfalls sind die untergeordneten Elemente deaktiviert und für den Benutzer nicht zugänglich.
Standardmäßig sind aktivierbare Gruppenfelder bereits markiert.
Hinweis: Das Gruppenfeld selbst wird nicht deaktiviert, wenn das Kontrollkästchen deaktiviert ist, und Sie können einzelne untergeordnete Elemente in einem deaktivierten Gruppenfeld explizit aktivieren. Dies wird jedoch nicht empfohlen, da es beim Endbenutzer zu Verwirrung führen könnte.
Zugriffsfunktionen:
| bool | isChecked() const |
| void | setChecked(bool checked) |
Benachrichtigungssignal:
| void | toggled(bool on) |
Siehe auch „ checkable “.
flat : bool
Diese Eigenschaft gilt unabhängig davon, ob die Gruppenbox flach dargestellt wird oder einen Rahmen hat
Ein Gruppenfeld besteht in der Regel aus einem umgebenden Rahmen mit einer Überschrift oben. Ist diese Eigenschaft aktiviert, wird bei den meisten Stilen nur der obere Teil des Rahmens gezeichnet; andernfalls wird der gesamte Rahmen gezeichnet.
Standardmäßig ist diese Eigenschaft deaktiviert, d. h., Gruppenfelder sind nicht flach, sofern dies nicht ausdrücklich festgelegt wird.
Hinweis: In einigen Stilen weisen flache und nicht-flache Gruppenfelder ähnliche Darstellungen auf und sind möglicherweise nicht so gut voneinander zu unterscheiden wie in anderen Stilen.
Access-Funktionen:
| bool | isFlat() const |
| void | setFlat(bool flat) |
Siehe auch „ title “.
title : QString
Diese Eigenschaft enthält den Titeltext des Gruppenfelds
Der Titeltext des Gruppenfelds verfügt über eine Tastenkombination, wenn der Titel ein Und-Zeichen („&“) gefolgt von einem Buchstaben enthält.
g->setTitle("&User information");Im obigen Beispiel verschiebt „ Alt+U “ den Tastaturfokus auf die Gruppenbox. Weitere Informationen finden Sie in der Dokumentation unter „ QShortcut “ (um ein echtes Und-Zeichen anzuzeigen, verwenden Sie „&&“).
Es gibt keinen Standard-Titeltext.
Zugriffsfunktionen:
| QString | title() const |
| void | setTitle(const QString &title) |
Siehe auch „Ausrichtung“.
Dokumentation zu den Member-Funktionen
[explicit] QGroupBox::QGroupBox(QWidget *parent = nullptr)
Erstellt ein Group-Box-Widget mit dem angegebenen „ parent “, jedoch ohne Titel.
[explicit] QGroupBox::QGroupBox(const QString &title, QWidget *parent = nullptr)
Erstellt ein Gruppenfeld mit den angegebenen Werten für „ title “ und „ parent “.
[virtual noexcept] QGroupBox::~QGroupBox()
Löscht das Gruppenfeld.
[override virtual protected] void QGroupBox::changeEvent(QEvent *ev)
Umsetzt: ` QWidget::changeEvent(QEvent *event)`.
[override virtual protected] void QGroupBox::childEvent(QChildEvent *c)
Implementiert: ` QObject::childEvent(QChildEvent *event)`.
[signal] void QGroupBox::clicked(bool checked = false)
Dieses Signal wird ausgelöst, wenn das Kontrollkästchen aktiviert wird (d. h. wenn die Maustaste gedrückt und wieder losgelassen wird, während sich der Mauszeiger innerhalb des Kontrollkästchens befindet) oder wenn die Tastenkombination eingegeben wird. Beachten Sie jedoch, dass dieses Signal nicht ausgelöst wird, wenn Sie ` setChecked()` aufrufen.
Ist das Kontrollkästchen aktiviert, ist ` checked ` wahr; ist es deaktiviert, ist es falsch.
Siehe auch „ checkable“ , „ toggled()“ und „ checked “.
[override virtual protected] bool QGroupBox::event(QEvent *e)
Umsetzt: ` QWidget::event(QEvent *event)`.
[override virtual protected] void QGroupBox::focusInEvent(QFocusEvent *fe)
Implementiert: ` QWidget::focusInEvent(QFocusEvent *event)`.
[virtual protected] void QGroupBox::initStyleOption(QStyleOptionGroupBox *option) const
Initialisieren Sie ` option ` mit den Werten aus dieser Datei: QGroupBox. Diese Methode ist für Unterklassen nützlich, wenn diese ein ` QStyleOptionGroupBox` benötigen, aber nicht alle Informationen selbst eingeben möchten.
Siehe auch ` QStyleOption::initFrom()`.
[override virtual] QSize QGroupBox::minimumSizeHint() const
Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::minimumSizeHint “ neu.
[override virtual protected] void QGroupBox::mouseMoveEvent(QMouseEvent *event)
Implementiert: ` QWidget::mouseMoveEvent` (`QMouseEvent *event`).
[override virtual protected] void QGroupBox::mousePressEvent(QMouseEvent *event)
Implementiert: ` QWidget::mousePressEvent` (`QMouseEvent *event`).
[override virtual protected] void QGroupBox::mouseReleaseEvent(QMouseEvent *event)
Implementiert: ` QWidget::mouseReleaseEvent` (`QMouseEvent *event`).
[override virtual protected] void QGroupBox::paintEvent(QPaintEvent *event)
Implementiert: QWidget::paintEvent(QPaintEvent *event).
[override virtual protected] void QGroupBox::resizeEvent(QResizeEvent *e)
Implementiert: QWidget::resizeEvent(QResizeEvent *event).
[signal] void QGroupBox::toggled(bool on)
Wenn das Kontrollkästchen aktiviert werden kann, wird dieses Signal ausgelöst, sobald der Status des Kontrollkästchens geändert wird. „ on “ ist wahr, wenn das Kontrollkästchen aktiviert ist; andernfalls ist es falsch.
Hinweis: Notifier -Signal für die Eigenschaft „ checked “.
Siehe auch „ checkable “.
© 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.
