QCheckBox Class
Le widget QCheckBox permet d'afficher une case à cocher accompagnée d'une étiquette de texte. En savoir plus...
| En-tête : | #include <QCheckBox> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | 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
Un 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 fonctionnalités d’une application pouvant être activées ou désactivées sans affecter les autres. Différents types de comportement peuvent être implémentés. Par exemple, une classe « QButtonGroup » peut être utilisée pour regrouper logiquement des boutons à cocher, permettant ainsi l’utilisation de cases à cocher exclusives. Cependant, la classe « QButtonGroup » ne fournit aucune représentation visuelle.
L’image ci-dessous illustre plus en détail les différences entre les cases à cocher exclusives et non exclusives.
 |  |
Chaque fois qu’une case à cocher est cochée ou décoché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 vérifier si une case à cocher est cochée ou non.
En plus des états habituels « coché » et « décoché », QCheckBox propose en option un troisième état indiquant « aucun changement ». Cela s’avère utile lorsque vous devez donner à l’utilisateur la possibilité de ne ni cocher ni décocher une case à cocher. Si vous avez besoin de ce troisième état, activez-le avec ` setTristate()` et utilisez ` checkState()` pour vérifier l’état actuel de la case à cocher.
Tout comme QPushButton, une case à cocher affiche du texte et, en option, une petite icône. L’icône est définie à l’aide de setIcon(). Le texte peut être défini dans le constructeur ou à l’aide de setText(). Une touche de raccourci peut être spécifiée en faisant précéder le caractère souhaité d’un esperluette. Par exemple :
Dans cet exemple, le raccourci est Alt+A. Consultez la documentation de ` QShortcut ` pour plus de détails. Pour afficher un « & » (et) réel, 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 ne dispose que de deux états.
Fonctions d’accès :
| bool | isTristate() const |
| void | setTristate(bool y = true) |
Documentation des fonctions membres
[explicit] QCheckBox::QCheckBox(QWidget *parent = nullptr)
Crée une case à cocher avec l'parent ion fournie, mais sans texte.
parent est transmis au constructeur de ` QAbstractButton `.
[explicit] QCheckBox::QCheckBox(const QString &text, QWidget *parent = nullptr)
Crée une case à cocher avec les paramètres ` parent ` et ` text` fournis.
parent est transmis au constructeur de ` QAbstractButton `.
[virtual noexcept] QCheckBox::~QCheckBox()
Destructeur.
Qt::CheckState QCheckBox::checkState() const
Renvoie l'état de sélection de la case à cocher. Si vous n'avez pas besoin de la prise en charge du mode « tristate », vous pouvez également utiliser la fonction QAbstractButton::isChecked(), qui renvoie une valeur booléenne.
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 la nouvelle é Qt::CheckState tion 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 provenant de cette page : QCheckBox. Cette méthode est utile pour les sous-classes qui ont besoin d'un ` QStyleOptionButton`, mais qui ne souhaitent pas renseigner elles-mêmes toutes les informations.
Voir également QStyleOption::initFrom().
[override virtual] QSize QCheckBox::minimumSizeHint() const
Réimplémente une fonction d'accès pour 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 sur « state ». Si vous n'avez pas besoin de la prise en charge du mode « tristate », vous pouvez également utiliser la fonction QAbstractButton::setChecked(), qui accepte un booléen.
Voir également checkState() et Qt::CheckState.
[override virtual] QSize QCheckBox::sizeHint() const
Réimplémente une fonction d'accès pour 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.
