QCheckBox Class
Le widget QCheckBox fournit une case à cocher avec une étiquette de texte. Plus d'informations...
| En-tête : | #include <QCheckBox> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Héritages : | QAbstractButton |
Propriétés
- tristate : bool
Fonctions publiques
| 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) |
Fonctions publiques réimplémentées
| virtual QSize | minimumSizeHint() const override |
| virtual QSize | sizeHint() const override |
Signaux
(since 6.7) void | checkStateChanged(Qt::CheckState state) |
Fonctions protégées
| virtual void | initStyleOption(QStyleOptionButton *option) const |
Fonctions protégées réimplémentées
| 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 |
Description détaillée
Une QCheckBox est un bouton d'option qui peut être activé (coché) ou désactivé (décoché). Les cases à cocher sont généralement utilisées pour représenter des fonctions d'une application qui peuvent être activées ou désactivées sans affecter les autres. Différents types de comportement peuvent être mis en œuvre. Par exemple, un site QButtonGroup peut être utilisé pour regrouper les cases à cocher de manière logique, ce qui permet d'avoir des cases à cocher exclusives. Cependant, QButtonGroup ne fournit aucune représentation visuelle.
L'image ci-dessous illustre les différences entre les cases à cocher exclusives et non exclusives.
 |  |
Chaque fois qu'une case à cocher est cochée ou effacée, elle émet le signal checkStateChanged(). Connectez-vous à ce signal si vous souhaitez déclencher une action à chaque fois que la case à cocher change d'état. Vous pouvez utiliser isChecked() pour demander si une case à cocher est cochée ou non.
En plus des états coché et non coché habituels, QCheckBox fournit optionnellement un troisième état pour indiquer "pas de changement". Cet état est utile lorsque vous devez donner à l'utilisateur la possibilité de ne pas cocher ou décocher une case à cocher. Si vous avez besoin de ce troisième état, activez-le avec setTristate(), et utilisez checkState() pour demander l'état de basculement actuel.
Tout comme QPushButton, une case à cocher affiche du texte et, éventuellement, une petite icône. L'icône est définie avec setIcon(). Le texte peut être défini dans le constructeur ou avec setText(). Une touche de raccourci peut être spécifiée en faisant précéder le caractère préféré d'une esperluette. Par exemple, dans cet exemple, le raccourci est le suivant
Dans cet exemple, le raccourci est Alt+A. Voir la documentation de QShortcut pour plus de détails. Pour afficher une véritable esperluette, utilisez '&&'.
Voir également QAbstractButton et QRadioButton.
Documentation sur les propriétés
tristate : bool
Cette propriété indique si la case à cocher est une case à cocher à trois états
La valeur par défaut est false, c'est-à-dire que la case à cocher n'a que deux états.
Fonctions d'accès :
| bool | isTristate() const |
| void | setTristate(bool y = true) |
Documentation des fonctions membres
[explicit] QCheckBox::QCheckBox(QWidget *parent = nullptr)
Construit une case à cocher avec la valeur donnée parent, mais sans texte.
parent est transmis au constructeur de QAbstractButton.
[explicit] QCheckBox::QCheckBox(const QString &text, QWidget *parent = nullptr)
Construit une case à cocher avec les données parent et text.
parent est transmis au constructeur de QAbstractButton.
[virtual noexcept] QCheckBox::~QCheckBox()
Destructeur.
Qt::CheckState QCheckBox::checkState() const
Renvoie l'état de la case à cocher. Si vous n'avez pas besoin d'un support tristate, vous pouvez également utiliser QAbstractButton::isChecked(), qui renvoie un booléen.
Voir également setCheckState() et Qt::CheckState.
[signal, since 6.7] void QCheckBox::checkStateChanged(Qt::CheckState state)
Ce signal est émis chaque fois que l'état de la case à cocher change, c'est-à-dire chaque fois que l'utilisateur la coche ou la décoche.
state contient le nouveau Qt::CheckState de la case à cocher.
Cette fonction a été introduite dans Qt 6.7.
[override virtual protected] void QCheckBox::checkStateSet()
Réimplémente : QAbstractButton::checkStateSet().
[override virtual protected] bool QCheckBox::event(QEvent *e)
Réimplémente : QAbstractButton::event(QEvent *e).
[override virtual protected] bool QCheckBox::hitButton(const QPoint &pos) const
Réimplémente : QAbstractButton::hitButton(const QPoint &pos) const.
[virtual protected] void QCheckBox::initStyleOption(QStyleOptionButton *option) const
Initialise option avec les valeurs de ce QCheckBox. Cette méthode est utile pour les sous-classes qui ont besoin d'un QStyleOptionButton, mais qui ne veulent pas remplir toutes les informations elles-mêmes.
Voir aussi QStyleOption::initFrom().
[override virtual] QSize QCheckBox::minimumSizeHint() const
Réimplémente une fonction d'accès à la propriété : QWidget::minimumSizeHint.
[override virtual protected] void QCheckBox::mouseMoveEvent(QMouseEvent *e)
Réimplémente : QAbstractButton::mouseMoveEvent(QMouseEvent *e).
[override virtual protected] void QCheckBox::nextCheckState()
Réimplémente : QAbstractButton::nextCheckState().
[override virtual protected] void QCheckBox::paintEvent(QPaintEvent *)
Réimplémente : QAbstractButton::paintEvent(QPaintEvent *e).
void QCheckBox::setCheckState(Qt::CheckState state)
Définit l'état de la case à cocher à state. Si vous n'avez pas besoin d'un support tristate, vous pouvez également utiliser QAbstractButton::setChecked(), qui prend un booléen.
Voir également checkState() et Qt::CheckState.
[override virtual] QSize QCheckBox::sizeHint() const
Réimplémente une fonction d'accès à la propriété : QWidget::sizeHint.
© 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.
