QGroupBox Class
Das QGroupBox-Widget bietet einen Gruppenrahmen mit einem Titel. Mehr...
| Kopfzeile: | #include <QGroupBox> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Vererbt: | 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 |
Reimplementierte öffentliche Funktionen
| virtual QSize | minimumSizeHint() const override |
Öffentliche Slots
| void | setChecked(bool checked) |
Signale
Geschützte Funktionen
| virtual void | initStyleOption(QStyleOptionGroupBox *option) const |
Reimplementierte 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 |
Detaillierte Beschreibung
Ein Gruppenrahmen bietet einen Rahmen, einen Titel oben, ein Tastaturkürzel und zeigt verschiedene andere Widgets in sich selbst an. Der Tastaturkurzbefehl verschiebt den Tastaturfokus auf eines der untergeordneten Widgets des Gruppenrahmens.
Mit QGroupBox können Sie auch die title (normalerweise im Konstruktor festgelegt) und die Ausrichtung des Titels festlegen. Gruppenrahmen können checkable sein. Kind-Widgets in ankreuzbaren Gruppenrahmen werden aktiviert oder deaktiviert, je nachdem, ob der Gruppenrahmen checked ist oder nicht.
Sie können den Platzbedarf eines Gruppenrahmens minimieren, indem Sie die Eigenschaft flat aktivieren. In den meisten styles führt die Aktivierung dieser Eigenschaft dazu, dass der linke, rechte und untere Rand des Rahmens entfernt wird.
QGroupBox legt nicht automatisch die untergeordneten Widgets an (die oft QCheckBoxes oder QRadioButtons sind, 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 der Eigenschaft
alignment : Qt::Alignment
Diese Eigenschaft bestimmt die Ausrichtung des Titels des Gruppenrahmens.
Die meisten Stile platzieren den Titel am oberen Rand des Rahmens. Die horizontale Ausrichtung des Titels kann mit einzelnen Werten aus der folgenden Liste festgelegt werden:
- Qt::AlignLeft Richtet den Titeltext an der linken Seite des Gruppenrahmens aus.
- Qt::AlignRight Richtet den Titeltext an der rechten Seite des Gruppenrahmens aus.
- Qt::AlignHCenter Richtet den Titeltext an der horizontalen Mitte des Gruppenrahmens aus.
Die Standardausrichtung ist Qt::AlignLeft.
Zugriffsfunktionen:
| Qt::Alignment | alignment() const |
| void | setAlignment(int alignment) |
Siehe auch Qt::Alignment.
checkable : bool
Diese Eigenschaft gibt an, ob der Gruppenrahmen ein Kontrollkästchen in seinem Titel hat
Wenn diese Eigenschaft true lautet, zeigt der Gruppenrahmen seinen Titel mit einem Kontrollkästchen anstelle einer normalen Beschriftung an. Ist das Kontrollkästchen angekreuzt, sind die untergeordneten Elemente des Gruppenrahmens aktiviert; andernfalls sind sie deaktiviert und unzugänglich.
Standardmäßig sind Gruppenrahmen nicht ankreuzbar.
Wenn diese Eigenschaft für einen Gruppenrahmen aktiviert ist, wird er anfangs auch überprüft, um sicherzustellen, dass sein Inhalt aktiviert ist.
Zugriffsfunktionen:
| bool | isCheckable() const |
| void | setCheckable(bool checkable) |
Siehe auch checked.
checked : bool
Diese Eigenschaft gibt an, ob das Gruppenfeld markiert ist
Wenn das Gruppenfeld angekreuzt werden kann, wird es mit einem Kontrollkästchen angezeigt. Wenn das Kontrollkästchen markiert ist, sind die untergeordneten Elemente des Gruppenrahmens aktiviert; andernfalls sind die untergeordneten Elemente deaktiviert und für den Benutzer unzugänglich.
Standardmäßig sind abhakbare Gruppenfelder auch abgehakt.
Zugriffsfunktionen:
| bool | isChecked() const |
| void | setChecked(bool checked) |
Benachrichtigungssignal:
| void | toggled(bool on) |
Siehe auch checkable.
flat : bool
Diese Eigenschaft gibt an, ob der Gruppenrahmen flach gezeichnet ist oder einen Rahmen hat
Ein Gruppenrahmen besteht in der Regel aus einem umlaufenden Rahmen mit einem Titel am oberen Rand. Wenn diese Eigenschaft aktiviert ist, wird in den meisten Stilen nur der obere Teil des Rahmens gezeichnet; andernfalls wird der gesamte Rahmen gezeichnet.
Standardmäßig ist diese Eigenschaft deaktiviert, d. h. Gruppenrahmen sind nicht flach, es sei denn, sie werden explizit angegeben.
Hinweis: In einigen Stilen haben flache und nicht flache Gruppenrahmen ähnliche Darstellungen und sind möglicherweise nicht so gut unterscheidbar wie in anderen Stilen.
Zugriffsfunktionen:
| bool | isFlat() const |
| void | setFlat(bool flat) |
Siehe auch title.
title : QString
Diese Eigenschaft enthält den Titeltext des Gruppenrahmens
Der Titeltext des Gruppenrahmens hat ein Tastaturkürzel, wenn der Titel ein kaufmännisches Und ('&') gefolgt von einem Buchstaben enthält.
g->setTitle("&User information");
Im obigen Beispiel bewegt Alt+U den Tastaturfokus auf den Gruppenrahmen. Einzelheiten finden Sie in der Dokumentation QShortcut (um ein echtes kaufmännisches Und-Zeichen anzuzeigen, verwenden Sie '&&').
Es gibt keinen Standardtiteltext.
Zugriffsfunktionen:
| QString | title() const |
| void | setTitle(const QString &title) |
Siehe auch Ausrichtung.
Dokumentation der Mitgliedsfunktionen
[explicit] QGroupBox::QGroupBox(QWidget *parent = nullptr)
Konstruiert ein Gruppenfeld-Widget mit der angegebenen parent, aber ohne Titel.
[explicit] QGroupBox::QGroupBox(const QString &title, QWidget *parent = nullptr)
Konstruiert einen Gruppenrahmen mit den angegebenen title und parent.
[virtual noexcept] QGroupBox::~QGroupBox()
Zerstört den Gruppenrahmen.
[override virtual protected] void QGroupBox::changeEvent(QEvent *ev)
Reimplements: QWidget::changeEvent(QEvent *Event).
[override virtual protected] void QGroupBox::childEvent(QChildEvent *c)
Reimplements: QObject::childEvent(QChildEvent *event).
[signal] void QGroupBox::clicked(bool checked = false)
Dieses Signal wird ausgegeben, wenn das Kontrollkästchen aktiviert wird (d. h. wenn der Mauszeiger auf der Schaltfläche steht und dann losgelassen wird) oder wenn die Tastenkombination eingegeben wird. Insbesondere wird dieses Signal nicht ausgegeben, wenn Sie setChecked() aufrufen.
Wenn das Kontrollkästchen markiert ist, ist checked wahr; es ist falsch, wenn das Kontrollkästchen nicht markiert ist.
Siehe auch checkable, toggled(), und checked.
[override virtual protected] bool QGroupBox::event(QEvent *e)
Reimplements: QWidget::event(QEvent *Event).
[override virtual protected] void QGroupBox::focusInEvent(QFocusEvent *fe)
Reimplements: QWidget::focusInEvent(QFocusEvent *event).
[virtual protected] void QGroupBox::initStyleOption(QStyleOptionGroupBox *option) const
Initialisieren Sie option mit den Werten aus dieser QGroupBox. Diese Methode ist nützlich für Unterklassen, wenn sie eine QStyleOptionGroupBox benötigen, aber nicht alle Informationen selbst eingeben wollen.
Siehe auch QStyleOption::initFrom().
[override virtual] QSize QGroupBox::minimumSizeHint() const
Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QWidget::minimumSizeHint.
[override virtual protected] void QGroupBox::mouseMoveEvent(QMouseEvent *event)
Reimplements: QWidget::mouseMoveEvent(QMouseEvent *event).
[override virtual protected] void QGroupBox::mousePressEvent(QMouseEvent *event)
Reimplements: QWidget::mousePressEvent(QMouseEvent *event).
[override virtual protected] void QGroupBox::mouseReleaseEvent(QMouseEvent *event)
Reimplements: QWidget::mouseReleaseEvent(QMouseEvent *event).
[override virtual protected] void QGroupBox::paintEvent(QPaintEvent *event)
Reimplements: QWidget::paintEvent(QPaintEvent *event).
[override virtual protected] void QGroupBox::resizeEvent(QResizeEvent *e)
Reimplements: QWidget::resizeEvent(QResizeEvent *event).
[signal] void QGroupBox::toggled(bool on)
Wenn das Gruppenfeld ankreuzbar ist, wird dieses Signal ausgegeben, wenn das Kontrollkästchen umgeschaltet wird. on ist wahr, wenn das Kontrollkästchen angekreuzt ist; andernfalls ist es falsch.
Hinweis: Benachrichtigungssignal für die Eigenschaft checked.
Siehe auch checkable.
© 2025 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.
