QCheckBox

Le widget QCheckBox fournit une case à cocher avec un label texte. Plus d'informations...

#include <QCheckBox>

Voir la position dans l'arbre des classes.

Héritage

Hérite de QAbstractButton.

Description détaillée

Le widget QCheckBox fournit une case à cocher avec un label texte.

Un QCheckBox est un bouton d'option qui peut être basculé sur marche (checked) ou arrêt (unchecked). Les cases à cocher sont typiquement utilisées pour représenter des caractéristiques dans une application qui peuvent être activées ou désactivées sans affecter les autres. Cependant, différents types de comportements peuvent être implémentés. Par exemple, un QButtonGroup peut être utilisé pour grouper logiquement des cases à cocher, et ainsi les rendre exclusives. Cependant, un objet QButtonGroup ne fournit aucune représentation visuelle.

L'image ci-dessous illustre davantage les différences entre les cases à cocher exclusives et non exclusives.

Chaque fois qu'une case est cochée ou décochée, le signal stateChanged() est émis. Connectez le signal si vous voulez déclencher une action à chaque fois que la case à cocher change d'état. Vous pouvez utiliser isChecked() pour savoir si la case est cochée ou pas.

En plus de l'habituel état coché ou décoché, QCheckBox fournit optionnellement un troisième état pour indiquer « aucun changement ». Cela est utile quand vous voulez que l'utilisateur n'ait pas la possibilité de changer l'état de la case à cocher, qu'elle soit cochée ou non. Si vous avez besoin de ce troisième état, activez-le avec setTristate() et utilisez checkState() pour interroger l'état de la case à cocher.

Tout comme un objet QPushButton, une case à cocher affiche un texte, et optionnellement une petite icône, 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 précédant le caractère préféré avec un '&'. Par exemple :

QCheckBox *checkbox = new QCheckBox("C&ase sensitive", this);

Dans cet exemple le raccourci est Alt+A. Voir la documentation de QShorcut pour plus de détails (pour afficher un '&', utilisez '&&').

Fonctions importantes héritées : text(), setText(), text(), pixmap(), setPixmap(), accel(), setAccel(), isToggleButton(), setDown(), isDown(), isOn(), checkState(), autoRepeat(), isExclusiveToggle(), group(), setAutoRepeat(), toggle(), pressed(), released(), clicked(), toggled(), checkState() et stateChanged().

	une case à cocher avec le style Macintosh.
	une case à cocher avec le style Windows XP.
	une case à cocher avec le style Plastique.

Voir aussi QAbstractButton, QRadioButton et Livre sur le design d'interface graphique : cases à cocher.

Propriétés

tristate : bool

Cette propriété définit si la case à cocher a trois états.

Par défaut elle est à false ; c'est-à-dire que la case à cocher a seulement deux états.

Fonctions d'accès

bool isTristate () const
void setTristate ( bool y = true )

Fonctions membres

QCheckBox::QCheckBox ( QWidget * parent = 0 )

Construit une case à cocher avec le parent donné, mais sans aucun texte.

parent est passé au constructeur de QAbstractButton.

QCheckBox::QCheckBox ( const QString & text, QWidget * parent = 0 )

Construit une case à cocher avec le parent et le texte donnés.

parent est passé au constructeur de QAbstractButton.

Qt::CheckState QCheckBox::checkState () const

Retourne l'état de la case à cocher. Si vous n'avez pas besoin des trois états, vous pouvez aussi utiliser QAbstractButton::isChecked() qui retourne un booléen.

Voir aussi setCheckState() et Qt::CheckState.

void QCheckBox::checkStateSet () [virtual protected]

Réimplémentation de QAbstractButton::checkStateSet().

bool QCheckBox::event ( QEvent * e ) [virtual protected]

Réimplémentation de QObject::event().

bool QCheckBox::hitButton ( const QPoint & pos ) const [virtual protected]

Réimplémentation de QAbstractButton::hitButton().

void QCheckBox::initStyleOption ( QStyleOptionButton * option ) const [protected]

Initialise option avec les valeurs de cet objet QCheckBox. Cette méthode est pratique pour les sous-classes qui nécessitent un QStyleOptionButton, mais qui ne veulent pas fournir toutes les informations elles-mêmes.

Voir aussi QStyleOption::initFrom().

void QCheckBox::mouseMoveEvent ( QMouseEvent * e ) [virtual protected]

Réimplémentation de QWidget::mouseMoveEvent().

void QCheckBox::nextCheckState () [virtual protected]

Réimplémentation de QAbstractButton::nextCheckState().

void QCheckBox::paintEvent ( QPaintEvent * ) [virtual protected]

Réimplémentation de QWidget::paintEvent().

void QCheckBox::setCheckState ( Qt::CheckState state )

Définit l'état state de la case à cocher. Si vous n'avez pas besoin des trois états, vous pouvez aussi utiliser QAbstractButton::setChecked() qui retourne un booléen.

Voir aussi checkState() et Qt::CheckState.

QSize QCheckBox::sizeHint () const [virtual]

Réimplémentation de QWidget::sizeHint().

void QCheckBox::stateChanged ( int state ) [signal]

Ce signal est émis si l'état de la case à cocher change, c'est à dire si l'utilisateur la coche ou la décoche.

state contient le nouvel état Qt::CheckState de la case à cocher.

Remerciements

Merci à Mikael Sans pour la traduction ainsi qu'à Jonathan Courtois, à Thibaut Cuvelier et à Jacques Thery pour leur relecture !