Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

QGroupBox Class

Le widget QGroupBox fournit un cadre de groupe avec un titre. Plus d'informations...

En-tête : #include <QGroupBox>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Héritages : 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

Emplacements publics

void setChecked(bool checked)

Signaux

void clicked(bool checked = false)
void toggled(bool on)

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

Cadre affichant plusieurs boutons radio

Un cadre de groupe fournit un cadre, un titre en haut, un raccourci clavier et affiche divers autres widgets à l'intérieur de lui-même. Le raccourci clavier permet de déplacer le focus clavier vers l'un des widgets enfants du cadre de groupe.

QGroupBox vous permet également de définir le title (normalement défini dans le constructeur) et le alignment du titre. Les cadres de groupe peuvent être checkable. Les widgets enfants des cadres à cocher sont activés ou désactivés selon que le cadre est ou non checked.

Vous pouvez minimiser l'espace occupé par un cadre 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 QCheckBoxes ou QRadioButtons mais peuvent être n'importe quels widgets). 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 sur les propriétés

alignment : Qt::Alignment

Cette propriété définit l'alignement du titre du cadre.

La plupart des styles placent le titre en haut du cadre. L'alignement horizontal du titre peut être spécifié à l'aide des valeurs individuelles de la liste suivante :

  • Qt::AlignLeft aligne le texte du titre sur le côté gauche du cadre.
  • Qt::AlignRight aligne le texte du titre sur le côté droit du cadre.
  • Qt::AlignHCenter aligne le texte du titre sur le centre horizontal du cadre.

L'alignement par défaut est Qt::AlignLeft.

Fonctions d'accès :

Qt::Alignment alignment() const
void setAlignment(int alignment)

Voir aussi Qt::Alignment.

checkable : bool

Cette propriété indique si le titre du cadre comporte une case à cocher

Si cette propriété vaut true, le cadre affiche son titre à l'aide d'une case à cocher au lieu d'une étiquette ordinaire. Si la case est cochée, les enfants du cadre sont activés ; dans le cas contraire, ils sont désactivés et inaccessibles.

Par défaut, les cadres ne sont pas cochables.

Si cette propriété est activée pour un cadre, celui-ci sera également vérifié initialement pour s'assurer que son contenu est activé.

Fonctions d'accès :

bool isCheckable() const
void setCheckable(bool checkable)

Voir également checked.

checked : bool

Cette propriété indique si le cadre est coché

Si le cadre est cochable, il est affiché avec une case à cocher. Si la case est cochée, les enfants du cadre sont activés ; dans le cas contraire, les enfants sont désactivés et inaccessibles à l'utilisateur.

Par défaut, les cadres à cocher sont également cochés.

Remarque : le cadre lui-même n'est pas désactivé lorsqu'il n'est pas coché, et vous pouvez explicitement activer les enfants d'un cadre qui n'est pas coché. Cela n'est toutefois pas recommandé, car cela pourrait créer une expérience surprenante pour l'utilisateur final.

Fonctions d'accès :

bool isChecked() const
void setChecked(bool checked)

Signal de notification :

void toggled(bool on)

Voir aussi checkable.

flat : bool

Cette propriété indique si le cadre du groupe est peint à plat ou s'il comporte un cadre

Un cadre de groupe se compose généralement d'un cadre qui l'entoure et d'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 ; sinon, le cadre entier est dessiné.

Par défaut, cette propriété est désactivée, c'est-à-dire que les cadres de groupe ne sont pas plats, sauf si cela est explicitement spécifié.

Remarque : dans certains styles, les cadres plats et non plats ont des représentations similaires et peuvent ne pas être aussi distincts 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 du cadre

Le texte du titre du cadre aura un raccourci clavier si le titre contient une esperluette ('&') suivie d'une lettre.

g->setTitle("&User information");

Dans l'exemple ci-dessus, Alt+U déplace le focus clavier vers le cadre. Voir la documentation de QShortcut pour plus de détails (pour afficher une esperluette, utiliser '&&').

Il n'y a pas de texte de titre par défaut.

Fonctions d'accès :

QString title() const
void setTitle(const QString &title)

Voir également l'alignement.

Documentation sur les fonctions membres

[explicit] QGroupBox::QGroupBox(QWidget *parent = nullptr)

Construit un widget de boîte de groupe avec l'adresse parent donnée, mais sans titre.

[explicit] QGroupBox::QGroupBox(const QString &title, QWidget *parent = nullptr)

Construit un cadre avec les données title et parent.

[virtual noexcept] QGroupBox::~QGroupBox()

Détruit le cadre du 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 lorsqu'on appuie dessus puis qu'on la relâche alors que le curseur de la souris se trouve à l'intérieur du bouton), ou lorsque la touche de raccourci est tapée. Notamment, ce signal n'est pas émis si vous appelez setChecked().

Si la case est cochée, checked est vrai ; il est faux si la case 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

Initialiser option avec les valeurs de QGroupBox. Cette méthode est utile pour les sous-classes qui ont besoin d'un QStyleOptionGroupBox, mais qui ne veulent pas remplir toutes les informations elles-mêmes.

Voir aussi QStyleOption::initFrom().

[override virtual] QSize QGroupBox::minimumSizeHint() const

Réimplémente une fonction d'accès à 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 case du groupe est cochable, ce signal est émis lorsque la case est cochée. on est vrai si la case est cochée ; sinon, il est faux.

Note : Signal de 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.