Developpez.com - Qt
X

Choisissez d'abord la catégorieensuite la rubrique :

Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Toutes les fonctions  ·  Vues d'ensemble  · 

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.

image image

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().

image une case à cocher avec le style Macintosh.
image une case à cocher avec le style Windows XP.
image 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 !

Publicité

Best Of

Actualités les plus lues

Semaine
Mois
Année
  1. Microsoft ouvre aux autres compilateurs C++ AMP, la spécification pour la conception d'applications parallèles C++ utilisant le GPU 22
  2. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 38
  3. Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  4. RIM : « 13 % des développeurs ont gagné plus de 100 000 $ sur l'AppWord », Qt et open-source au menu du BlackBerry DevCon Europe 0
  5. BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
  6. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
  7. Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
Page suivante

Le Qt Quarterly au hasard

Logo

Le repérage des paires de parenthèses avec QSyntaxHighlighter

Qt Quarterly est la revue trimestrielle proposée par Nokia et à destination des développeurs Qt. Ces articles d'une grande qualité technique sont rédigés par des experts Qt. Lire l'article.

Communauté

Ressources

Liens utiles

Contact

  • Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 4.7
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
 
 
 
 
Partenaires

Hébergement Web

Responsable bénévole de la rubrique Qt : Thibaut Cuvelier -