===== QCheckBox ===== Le widget QCheckBox fournit une case à cocher avec un label texte. [[#Description détaillée|Plus d'informations...]] ==== 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. | {{http://qt.developpez.com/doc/4.6/images/checkboxes-exclusive.png|}} | {{http://qt.developpez.com/doc/4.6/images/checkboxes-non-exclusive.png|}} | 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 [[qabstractbutton#checked-prop|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 [[qcheckbox#tristate-prop|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 [[qabstractbutton#icon-prop|setIcon()]]. Le texte peut être défini dans le constructeur ou avec [[qabstractbutton#text-prop|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 : [[qabstractbutton#text-prop|text()]], [[qabstractbutton#text-prop|setText()]], [[qabstractbutton#text-prop|text()]], [[qabstractbutton-qt3#pixmap()]], [[qabstractbutton-qt3#setPixmap()]], [[qabstractbutton-qt3#accel()]], [[qabstractbutton-qt3#setAccel()]], [[qabstractbutton-qt3#isToggleButton()]], [[qabstractbutton#down-prop|setDown()]], [[qabstractbutton#down-prop|isDown()]], [[qabstractbutton-qt3#isOn()]], [[#checkState()]], [[qabstractbutton#autoRepeat-prop|autoRepeat()]], isExclusiveToggle(), [[qabstractbutton#group()]], [[qabstractbutton#autoRepeat-prop|setAutoRepeat()]], [[qabstractbutton#toggle()]], [[qabstractbutton#pressed()]], [[qabstractbutton#released()]], [[qabstractbutton#clicked()]], [[qabstractbutton#toggled()]], [[#checkState()]] et [[#stateChanged()]]. | {{http://qt.developpez.com/doc/4.6/images/macintosh-checkbox.png}} | une case à cocher avec le [[style_macintosh|style Macintosh]]. | | {{http://qt.developpez.com/doc/4.6/images/windows-checkbox.png}} | une case à cocher avec le [[style_windowsxp|style Windows XP]]. | | {{http://qt.developpez.com/doc/4.6/images/plastique-checkbox.png}} | une case à cocher avec le [[style_plastique|style Plastique]]. | Voir aussi [[QAbstractButton]], [[QRadioButton]] et [[guibooks#fowler|Livre sur le design d'interface graphique : cases à cocher]]. ====Propriétés==== === tristate-prop === ''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::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::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]]. === checkState() === ''[[qt#CheckState-enum|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#checked-prop|QAbstractButton::isChecked()]] qui retourne un booléen. Voir aussi [[#setCheckState()]] et [[qt#CheckState-enum|Qt::CheckState]]. === checkStateSet() === ''void QCheckBox::checkStateSet () [virtual protected]'' Réimplémentation de [[qabstractbutton#checkStateSet|QAbstractButton::checkStateSet()]]. === event() === ''bool QCheckBox::event ( [[QEvent]] * e ) [virtual protected]'' Réimplémentation de [[qobject#event|QObject::event()]]. === hitButton() === ''bool QCheckBox::hitButton ( const [[QPoint]] & pos ) const [virtual protected]'' Réimplémentation de [[qabstractbutton#hitButton|QAbstractButton::hitButton()]]. === initStyleOption() === ''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|QStyleOption::initFrom()]]. === mouseMoveEvent() === ''void QCheckBox::mouseMoveEvent ( [[QMouseEvent]] * e ) [virtual protected]'' Réimplémentation de [[qwidget#mouseMoveEvent|QWidget::mouseMoveEvent()]]. === nextCheckState() === ''void QCheckBox::nextCheckState () [virtual protected]'' Réimplémentation de [[qabstractbutton#nextCheckState|QAbstractButton::nextCheckState()]]. === paintEvent() === ''void QCheckBox::paintEvent ( [[QPaintEvent]] * ) [virtual protected]'' Réimplémentation de [[qwidget#paintEvent|QWidget::paintEvent()]]. === setCheckState() === ''void QCheckBox::setCheckState ( [[qt#CheckState-enum|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#checked-prop|QAbstractButton::setChecked()]] qui retourne un booléen. Voir aussi [[#checkState()]] et [[qt#CheckState-enum|Qt::CheckState]]. === sizeHint() === ''[[QSize]] QCheckBox::sizeHint () const [virtual]'' Réimplémentation de [[qwidget#sizeHint|QWidget::sizeHint()]]. === stateChanged() === ''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-enum|Qt::CheckState]] de la case à cocher. ==== Remerciements ==== Merci à pour la traduction ainsi qu'à , à et à pour leur relecture !