QGroupBox Class
Le widget QGroupBox fournit un cadre de groupe doté d'un titre. En savoir plus...
| En-tête : | #include <QGroupBox> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QWidget |
Propriétés
Fonctions publiques
| 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 |
Fonctions publiques réimplémentées
| virtual QSize | minimumSizeHint() const override |
Slots publics
| void | setChecked(bool checked) |
Signaux
Fonctions protégées
| virtual void | initStyleOption(QStyleOptionGroupBox *option) const |
Fonctions protégées réimplémentées
| 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 |
Description détaillée
Une zone de groupe fournit un cadre, un titre en haut, un raccourci clavier et affiche divers autres widgets à l'intérieur. Le raccourci clavier déplace le focus clavier vers l'un des widgets enfants de la zone de groupe.
QGroupBox vous permet également de définir la propriété « title » (généralement définie dans le constructeur) et la propriété « alignment » du titre. Les zones de groupe peuvent être « checkable ». Les widgets enfants des zones de groupe cochables sont activés ou désactivés selon que la zone de groupe est « checked » ou non.
Vous pouvez réduire l’espace occupé par une boîte de groupe en activant la propriété « flat ». Dans la plupart des cas styles, l’activation de cette propriété entraîne la suppression des bords gauche, droit et inférieur du cadre.
QGroupBox ne dispose pas automatiquement les widgets enfants (qui sont souvent des QCheckBoxs ou des QRadioButtons, mais peuvent être n'importe quel type de widget). L'exemple suivant montre comment configurer une QGroupBox avec une disposition :
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);Voir aussi QButtonGroup.
Documentation des propriétés
alignment : Qt::Alignment
Cette propriété définit l'alignement du titre de la zone de groupe.
La plupart des styles placent le titre en haut du cadre. L'alignement horizontal du titre peut être spécifié à l'aide de valeurs uniques issues de la liste suivante :
- Qt::AlignLeft aligne le texte du titre sur le bord gauche de la zone de groupe.
- Qt::AlignRight aligne le texte du titre sur le bord droit de la zone de groupe.
- Qt::AlignHCenter aligne le texte du titre sur le centre horizontal de la zone de groupe.
L'alignement par défaut est « Qt::AlignLeft ».
Fonctions d'Access :
| Qt::Alignment | alignment() const |
| void | setAlignment(int alignment) |
Voir également Qt::Alignment.
checkable : bool
Cette propriété indique si la zone de groupe comporte une case à cocher dans son titre
Si cette propriété est définie sur « true », la zone de groupe affiche son titre à l'aide d'une case à cocher à la place d'une étiquette classique. Si la case à cocher est cochée, les éléments enfants de la zone de groupe sont activés ; dans le cas contraire, ils sont désactivés et inaccessibles.
Par défaut, les zones de groupe ne sont pas cochables.
Si cette propriété est activée pour une zone de groupe, la case à cocher sera également cochée par défaut afin de garantir que son contenu soit activé.
Fonctions d'accès :
| bool | isCheckable() const |
| void | setCheckable(bool checkable) |
Voir également checked.
checked : bool
Cette propriété indique si la case de groupe est cochée
Si la case d'en-tête est cochable, elle s'affiche avec une case à cocher. Si la case à cocher est cochée, les éléments enfants de la case d'en-tête sont activés ; dans le cas contraire, ils sont désactivés et inaccessibles à l'utilisateur.
Par défaut, les zones de groupe cochables sont également cochées.
Remarque : la zone de groupe elle-même n’est pas désactivée lorsque la case est décochée, et vous pouvez activer explicitement des éléments enfants individuels dans une zone de groupe décochée. Cela n’est toutefois pas recommandé, car cela pourrait créer une expérience inattendue pour l’utilisateur final.
Fonctions d’accès :
| bool | isChecked() const |
| void | setChecked(bool checked) |
Signal de notification :
| void | toggled(bool on) |
Voir également checkable.
flat : bool
Cette propriété s'applique que la zone de groupe soit affichée sans cadre ou qu'elle comporte un cadre
Une zone de groupe se compose généralement d'un cadre avec un titre en haut. Si cette propriété est activée, seule la partie supérieure du cadre est dessinée dans la plupart des styles ; dans le cas contraire, le cadre est dessiné dans son intégralité.
Par défaut, cette propriété est désactivée, c'est-à-dire que les zones de groupe ne sont pas « plates » sauf indication contraire explicite.
Remarque : dans certains styles, les zones de groupe plates et non plates ont des représentations similaires et peuvent ne pas être aussi faciles à distinguer que dans d’autres styles.
Fonctions d’accès :
| bool | isFlat() const |
| void | setFlat(bool flat) |
Voir également title.
title : QString
Cette propriété contient le texte du titre de la zone de groupe
Le texte du titre de la zone de groupe disposera d'un raccourci clavier si le titre contient un « & » suivi d'une lettre.
g->setTitle("&User information");Dans l'exemple ci-dessus, la combinaison de touches « Alt+U » déplace le focus clavier vers la zone de groupe. Consultez la documentation relative à la fonction « QShortcut » pour plus de détails (pour afficher un « et commercial » réel, utilisez « && »).
Il n'y a pas de texte de titre par défaut.
Fonctions d'Access :
| QString | title() const |
| void | setTitle(const QString &title) |
Voir également «alignement ».
Documentation sur les fonctions membres
[explicit] QGroupBox::QGroupBox(QWidget *parent = nullptr)
Crée un widget « group box » avec l'parent s fournies, mais sans titre.
[explicit] QGroupBox::QGroupBox(const QString &title, QWidget *parent = nullptr)
Crée une zone de groupe avec les paramètres ` title ` et ` parent` indiqués.
[virtual noexcept] QGroupBox::~QGroupBox()
Supprime la zone de groupe.
[override virtual protected] void QGroupBox::changeEvent(QEvent *ev)
Réimplémente : QWidget::changeEvent(QEvent *event).
[override virtual protected] void QGroupBox::childEvent(QChildEvent *c)
Réimplémente : QObject::childEvent(QChildEvent *event).
[signal] void QGroupBox::clicked(bool checked = false)
Ce signal est émis lorsque la case à cocher est activée (c'est-à-dire lorsque l'on appuie puis relâche le bouton de la souris alors que le curseur se trouve à l'intérieur de la case), ou lorsque l'on appuie sur la touche de raccourci. Il est à noter que ce signal n' est pas émis si vous appelez la méthode ` setChecked()`.
Si la case à cocher est cochée, ` checked ` est vrai ; il est faux si la case à cocher n'est pas cochée.
Voir également checkable, toggled() et checked.
[override virtual protected] bool QGroupBox::event(QEvent *e)
Réimplémente : QWidget::event(QEvent *event).
[override virtual protected] void QGroupBox::focusInEvent(QFocusEvent *fe)
Réimplémente : QWidget::focusInEvent(QFocusEvent *event).
[virtual protected] void QGroupBox::initStyleOption(QStyleOptionGroupBox *option) const
Initialisez ` option ` avec les valeurs fournies à l'adresse suivante : QGroupBox. Cette méthode est utile pour les sous-classes qui ont besoin d'un ` QStyleOptionGroupBox`, mais ne souhaitent pas renseigner elles-mêmes toutes les informations.
Voir également QStyleOption::initFrom().
[override virtual] QSize QGroupBox::minimumSizeHint() const
Réimplémente une fonction d'accès pour la propriété : QWidget::minimumSizeHint.
[override virtual protected] void QGroupBox::mouseMoveEvent(QMouseEvent *event)
Réimplémente : QWidget::mouseMoveEvent(QMouseEvent *event).
[override virtual protected] void QGroupBox::mousePressEvent(QMouseEvent *event)
Réimplémente : QWidget::mousePressEvent(QMouseEvent *event).
[override virtual protected] void QGroupBox::mouseReleaseEvent(QMouseEvent *event)
Réimplémente : QWidget::mouseReleaseEvent(QMouseEvent *event).
[override virtual protected] void QGroupBox::paintEvent(QPaintEvent *event)
Réimplémente : QWidget::paintEvent(QPaintEvent *event).
[override virtual protected] void QGroupBox::resizeEvent(QResizeEvent *e)
Réimplémente : QWidget::resizeEvent(QResizeEvent *event).
[signal] void QGroupBox::toggled(bool on)
Si la zone de groupe comporte une case à cocher, ce signal est émis lorsque la case est cochée ou décochée. La propriété ` on ` est vraie si la case est cochée ; sinon, elle est fausse.
Remarque : signalde notification pour la propriété checked.
Voir également 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.
