QPushButton

Le widget QPushButton fournit un bouton de commande. Plus d'informations...

#include <QPushButton>

Voir la position dans l'arbre des classes.

H�ritage

H�rite de QAbstractButton.

H�rit� par QCommandLinkButton.

Description d�taill�e

Le widget QPushButton fournit un bouton de commande.

Le bouton, ou bouton de commande, est peut-�tre le widget le plus commun�ment utilis� dans toute interface graphique : appuyer sur un bouton pour ordonner � l'ordinateur d'effectuer une action ou pour r�pondre � une question. Les boutons typiques sont OK, Appliquer, Annuler, Fermer, Oui, Non et Aide.

Un bouton de commande est de forme rectangulaire et affiche en g�n�ral un texte d�crivant son action. Un raccourci peut �tre sp�cifi� en pr�c�dant le caract�re privil�gi� avec une esperluette (&). Par exemple :

QPushButton *button = new QPushButton("&T�l�charger", this);

Dans cet exemple, le raccourci est Alt+T. Voir la documentation de QShortcut pour plus de d�tails (pour afficher une esperluette existante, utilisez '&&').

Les boutons affichent un libell� textuel et optionnellement une petite ic�ne. Ils peuvent �tre d�finis par l'utilisation des constructeurs et modifi�s par la suite par l'utilisation de setText() et setIcon(). Si le bouton est d�sactiv�, l'apparence du texte et de l'ic�ne sera manipul�e en conformit� avec le style de d'interface graphique, de mani�re � donner une apparence « d�sactiv�e » au bouton.

Un bouton �met le signal clicked() quand il est activ� par la souris, la barre d'espace ou par un raccourci de clavier. Connectez ce signal pour effectuer l'action du bouton. Les boutons fournissent aussi des signaux moins commun�ment utilis�s, par exemple, pressed() et released().

Les boutons de commande dans les bo�tes de dialogue sont par d�faut des boutons automatiques, c'est-�-dire qu'ils deviennent boutons par d�faut automatiquement quand ils re�oivent le focus de l'entr�e du clavier. Un bouton par d�faut est un bouton qui est activ� quand l'utilisateur appuie sur les touches Entr�e ou Retour dans une bo�te de dialogue. Vous pouvez changer cela avec setAutoDefault. Notez que les boutons automatiques par d�faut r�servent un petit peu plus d'espace n�cessaire pour dessiner un indicateur de bouton par d�faut. Si vous ne voulez pas de cet espace autour de votre bouton, appelez setAutoDefault(false).

Devenant tr�s central, le widget bouton a �t� am�lior� pour accueillir un grand nombre de variations au cours de la derni�re d�cennie. Le guide du style Microsoft montre actuellement une dizaine d'�tats diff�rents de boutons sous Windows et le texte implique qu'il y en ait des douzaines d'autres quand toutes les combinaisons de caract�ristiques sont prises en consid�ration.

Les modes ou �tats les plus importants sont :

• disponible ou non (gris� et d�sactiv�) ;
• bouton standard, bouton r�versible ou bouton de menu ;
• zctiv� ou d�sactiv� (uniquement pour les boutons r�versibles) ;
• par d�faut ou normal : le bouton par d�faut d'une bo�te de dialogue peut g�n�ralement �tre activ� par l'utilisation des touches Entr�e ou Retour ;
• r�p�titif automatiquement ou non ;
• enfonc� ou non.

En r�gle g�n�rale, utilisez un bouton d'action quand la situation le requiert : par exemple avec une bo�te de dialogue lors d'un clic sur des boutons Appliquer, Annuler, Fermer et Aide). Le widget est alors repr�sent� par un pav� rectangulaire avec un texte � l'int�rieur. � l'inverse, les petits boutons, de forme carr�e, sont destin�s � un changement d'�tat de la fen�tre plut�t qu'� une action sur celle-ci (par exemple, les boutons situ�s dans le coin en haut � droite du QFileDialog, des boutons d'outils et non de commande) : Qt dispose dans ce cas de la classe sp�cifique QToolButton.

Si vous avez besoin d'un comportement r�versible (voir setCheckable()) ou d'un bouton r�p�tant automatiquement le signal d'activation lorsqu'il est enfonc� comme la fl�che d'une barre de d�filement (voir setAutoRepeat()), un bouton de commande n'est probablement pas ce que vous voulez. Dans le doute, utilisez un bouton d'outils.

Une variante du bouton de commande est le bouton de menu. Les boutons de menu ne fournissent pas uniquement une commande, mais plusieurs. D�s qu'ils sont appuy�s, ils font surgir un menu d'options. Utilisez la m�thode setMenu() pour associer un menu contextuel � un bouton.

D'autres classes de boutons sont les boutons d'options (voir QRadioButton) et les cases � cocher (voir QCheckBox).

	Un bouton affich� sous le style de widget Macintosh. Notez que lorsque la longueur devient inf�rieure � 50 ou que sa largeur devient inf�rieure � 30, les coins du bouton passent de la forme ronde � la forme carr�e. Utilisez la fonction setMinimumSize() pour �viter ce comportement.
	Un bouton affich� sous le style de widget Windows XP.
	Un bouton affich� sous le style de widget Plastique.

Dans Qt, la classe de base QAbstractButton fournit la plupart des modes et d'autres API, et QPushButton fournit la logique des GUI. Voir QAbstractButton pour plus d'informations � propos de l'API.

Voir aussi QToolButton, QRadioButton, QCheckBox et Le manuel du design de GUI : Boutons.

Propri�t�s

autoDefault : bool

Cette propri�t� contr�le si le bouton est un bouton automatique par d�faut.

Si cette propri�t� est d�finie � true, alors le bouton est un bouton automatique par d�faut.

Dans certains styles de GUI, un bouton par d�faut est dessin� avec un cadre suppl�mentaire l'entourant, jusqu'� 3 pixels ou plus. Qt garde automatiquement cet espace libre autour des boutons automatiques par d�faut, c'est-�-dire que ces derniers peuvent avoir des dimensions conseill�es l�g�rement plus grandes.

Cette propri�t� est par d�faut true pour les boutons qui d�tiennent un parent de QDialog ; sinon par d�faut false.

Voir la propri�t� default pour plus de d�tails sur la mani�re de d�finir par d�faut et d'auto-interagir par d�faut.

Fonctions d'acc�s

bool autoDefault () const
void setAutoDefault ( bool )

default : bool

Cette propri�t� contr�le si le bouton est le bouton par d�faut.

Les boutons par d�faut et les boutons automatiquement par d�faut prennent la d�cision de ce qui ce passe quand l'utilisateur appuie sur Entr�e dans une bo�te de dialogue.

Un bouton avec cette propri�t� d�finie comme true (c'est-�-dire le bouton par d�faut de la bo�te de dialogue) sera automatiquement enfonc� quand l'utilisateur pressera la touche Entr�e, avec une exception : si un bouton automatiquement par d�faut d�tient actuellement le focus, ce bouton est press�. Quand la bo�te de dialogue poss�de un bouton automatiquement par d�faut mais pas de bouton par d�faut, l'appui sur Entr�e va presser soit le bouton automatiquement par d�faut qui d�tient actuellement le focus, soit s'il n'y a pas de bouton ayant le focus, le bouton automatiquement par d�faut suivant dans l'ordre de focus.

Dans la bo�te de dialogue, seulement un bouton � la fois peut �tre le bouton par d�faut. Ce bouton est alors affich� avec un cadre additionnel (d�pendant du style de GUI).

Le comportement par d�faut du bouton est fourni uniquement dans les bo�tes de dialogue. Le bouton qui a le focus peut toujours �tre cliqu� depuis le clavier par une pression sur la barre d'espace.

Si la propri�t� par d�faut est d�finie � false dans l'actuel bouton par d�faut quand la bo�te de dialogue est visible, un nouveau param�tre par d�faut sera automatiquement assign� la prochaine fois qu'un bouton de la bo�te de dialogue recevra le focus.

Cette propri�t� est par d�faut false.

Fonctions d'acc�s

bool isDefault () const
void setDefault ( bool )

flat : bool

Cette propri�t� contr�le si la bordure du bouton est relev�e.

Cette propri�t� est par d�faut false. Si la propri�t� est d�finie, la plupart des styles ne va pas peindre l'arri�re-plan � moins que le bouton soit en train d'�tre press�. setAutoFillBackground() peut �tre utilis� pour faire en sorte que l'arri�re-plan soit rempli en utilisant le pinceau QPalette::Button.

Fonctions d'acc�s

bool isFlat () const
void setFlat ( bool )

Fonctions membres

QPushButton::QPushButton ( QWidget * parent = 0 )

Construit un bouton sans texte et un parent.

QPushButton::QPushButton ( const QString & texte, QWidget * parent = 0 )

Construit un bouton avec le parent parent et le texte texte.

QPushButton::QPushButton ( const QIcon & icone, const QString & texte, QWidget * parent = 0 )

Construit un bouton avec une icone, un texte et un parent.

Notez que vous pouvez aussi passer un objet QPixmap en tant qu'ic�ne (merci � l'implicite conversion fournie par le C++).

QPushButton::~QPushButton ()

D�truit le bouton.

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

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

void QPushButton::focusInEvent ( QFocusEvent * e ) [virtual protected]

R�impl�mentation de QWidget::focusInEvent().

void QPushButton::focusOutEvent ( QFocusEvent * e ) [virtual protected]

R�impl�mentation de QWidget::focusOutEvent().

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

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

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

Initialise option avec les valeurs de ce QPushButton. Cette m�thode est pratique pour les sous-classes quand elles n�cessitent un QStyleOptionButton, mais ne veulent pas fournir toutes les informations elles-m�mes.

void QPushButton::keyPressEvent ( QKeyEvent * e ) [virtual protected]

R�impl�mentation de QWidget::keyPressEvent().

QMenu * QPushButton::menu () const

Retourne le menu surgissant associ� au bouton ou 0 s'il n'y a pas de menu surgissant ayant �t� d�fini.

Voir aussi setMenu().

QSize QPushButton::minimumSizeHint () const [virtual]

R�impl�mentation de QWidget::minimumSizeHint().

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

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

void QPushButton::setMenu ( QMenu * menu )

Associe le menu surgissant menu avec ce bouton. Cela transforme le bouton en bouton-menu qui, dans certains styles, va produire un petit triangle � droite du texte du bouton.

Le propri�taire du menu n'est pas transf�r� au bouton.

Boutons avec menu surgissant affich�s dans le style de widget Plastique (gauche) et dans le style de widget Cleanlooks (droite).

void QPushButton::showMenu () [slot]

Affiche (fait surgir) le menu surgissant associ�. S'il n'y a pas un tel menu, cette fonction ne fait rien. Cette fonction ne retourne rien jusqu'� ce que le menu ait �t� ferm� par l'utilisateur.

QSize QPushButton::sizeHint () const [virtual]

R�impl�mentation dation QWidget::sizeHint().

Remerciements

Merci � Louis du Verdier pour la traduction et � Thibaut Cuvelier, Jonathan Courtois, Jacques Thery, Philippe Beaucart et � Wachter pour leur relecture et d�bat !