PyQt/QPushButton

Un livre de Wikilivres.
PyQt
PyQt
PyQt
Introduction
Installation
Concepts de base
Quelques widgets
Utilisation de Qt Designer
Guide de traduction de Qt à PyQt
Annexes
Modifier ce modèle ce sommaire

Description[modifier | modifier le wikicode]

La classe QPushButton met à disposition un bouton de commande. C'est certainement l'un des éléments graphiques le plus utilisé dans une interface pour réaliser des actions de la part de l'utilisateur.

Cet élément permet d'afficher du texte ou une image, ainsi qu'optionnellement une petite icône. Le texte peut afficher la touche accélératrice grâce à l'utilisation du caractère & devant la lettre symbolisant la touche. Toutes ces propriétés peuvent soit être mises en place grâce au constructeur de la classe, soit par l'intermédiaire d'appel à des méthodes sur l'objet. Il est aussi possible de désactiver le bouton. L'utilisateur ne pourra alors plus cliquer dessus, et l'aspect graphique du bouton sera tel que l'utilisateur est informé de la non-activation du bouton (généralement le texte du bouton est grisé, mais cela dépend du système de fenêtrage utilisé).

Un bouton poussoir émet le signal clicked()) quand il est activé par un clic de la souris ou bien par le clavier. Mais les boutons mettent aussi à disposition les signaux pressed() (pressé) et released() (relaché), qui sont nettement moins utilisés en pratique.

Les boutons contenus dans des boîtes de dialogue sont définis comme boutons par défaut, à savoir qu'ils obtiennent automatiquement le focus clavier lors de l'ouverture de la boîte de dialogue. L'utilisateur n'a alors qu'à presser sur « Entrée » pour activer le bouton. Ce comportement est modifiable par la méthode setAutoDefault(). Il est aussi possible de modifier le comportement du bouton pour qu'il reste activé lorsque l'utilisateur clique dessus. Ce comportement est mis en place grâce à la méthode setToggleButton(). Il est aussi possible de faire en sorte que le bouton répète son action tant que l'utilisateur le maintient cliqué ou activé par le clavier. Pour cela nous vous laissons consulter la documentation de référence de la classe.

Une variante d'un bouton de commande est un bouton menu. Il met alors à disposition plusieurs actions, qui sont choisies grâce à un menu déroulant affiché lorsque l'utilisateur clique sur le bouton. La méthode setPopup()) permet d'associer un menu déroulant à un bouton. Pour la création d'un menu déroulant, référez-vous à la section parlant de la classe QPopupMenu.

Constructeur[modifier | modifier le wikicode]

# Constructeurs pour la classe QPushButton
QPushButton ( QWidget parent, str name = "" )
QPushButton ( Qstr text, QWidget parent, str name = "" )
QPushButton ( QIconSet icon, Qstr text, QWidget parent, str name = "" )

Exemple[modifier | modifier le wikicode]