QPushButton Class

Description détaillée

Le bouton-poussoir, ou bouton de commande, est sans doute le widget le plus couramment utilisé dans toute interface utilisateur graphique. Appuyez (cliquez) sur un bouton pour demander à l'ordinateur d'effectuer une action ou de répondre à une question. Les boutons classiques sont OK, Appliquer, Annuler, Fermer, Oui, Non et Aide.

Un bouton de commande est rectangulaire et affiche généralement une étiquette textuelle décrivant son action. Une touche de raccourci peut être spécifiée en faisant précéder le caractère souhaité d’un « & » dans le texte. Par exemple :

QPushButton *button = new QPushButton("&Download", this);

Dans cet exemple, le raccourci est Alt+D. Consultez la documentation d’ QShortcut pour plus de détails (pour afficher un véritable « & », utilisez « && »).

Les boutons poussoirs affichent une étiquette textuelle et, éventuellement, une petite icône. Celles-ci peuvent être définies à l’aide des constructeurs, puis modifiées ultérieurement via les méthodes setText() et setIcon(). Si le bouton est désactivé, l’apparence du texte et de l’icône sera adaptée au style de l’interface graphique afin de donner au bouton un aspect « désactivé ».

Un bouton émet le signal clicked() lorsqu’il est activé par la souris, la barre d’espace ou un raccourci clavier. Connectez-vous à ce signal pour exécuter l’action du bouton. Les boutons fournissent également des signaux moins couramment utilisés, par exemple pressed() et released().

connect(dispenseButton, &QPushButton::clicked, this, &IceCreamMaker::dispense);

Les boutons de commande des boîtes de dialogue sont, par défaut, des boutons par défaut automatiques, c'est-à-dire qu'ils deviennent automatiquement le bouton par défaut lorsqu'ils reçoivent le focus du clavier. Un bouton par défaut est un bouton qui s’active lorsque l’utilisateur appuie sur la touche Entrée ou Retour dans une boîte de dialogue. Vous pouvez modifier ce comportement à l’aide de la fonction setAutoDefault(). Notez que les boutons par défaut automatiques réservent un peu d’espace supplémentaire, nécessaire pour afficher l’indicateur de bouton par défaut. Si vous ne souhaitez pas cet espace autour de vos boutons, appelez la fonction setAutoDefault(false).

En raison de son importance centrale, le widget « bouton » a évolué au cours de la dernière décennie pour s’adapter à un grand nombre de variantes. Le guide de style de Microsoft présente désormais une dizaine d’états différents pour les boutons de Windows, et le texte laisse entendre qu’il en existe des dizaines d’autres si l’on prend en compte toutes les combinaisons de fonctionnalités.

Les modes ou états les plus importants sont les suivants :

• Disponible ou non (grisé, désactivé).
• Bouton standard, bouton à bascule ou bouton de menu.
• Activé ou désactivé (uniquement pour les boutons à bascule).
• Par défaut ou normal. Le bouton par défaut d’une boîte de dialogue peut généralement être « cliqué » à l’aide de la touche Entrée ou Retour.
• Répétition automatique ou non.
• Enfoncé ou non.

En règle générale, utilisez un bouton lorsque l’application ou la fenêtre de dialogue exécute une action lorsque l’utilisateur clique dessus (comme Appliquer, Annuler, Fermer et Aide) et lorsque le widget est censé avoir une forme rectangulaire large avec une étiquette de texte. Les petits boutons, généralement carrés, qui modifient l’état de la fenêtre plutôt que d’effectuer une action (tels que les boutons situés dans le coin supérieur droit de l QFileDialog) ne sont pas des boutons de commande, mais des boutons d’outils. Qt fournit une classe spéciale (QToolButton) pour ces boutons.

Si vous avez besoin d’un comportement de basculement (voir setCheckable()) ou d’un bouton qui répète automatiquement le signal d’activation lorsqu’il est enfoncé, comme les flèches d’une barre de défilement (voir setAutoRepeat()), un bouton de commande n’est probablement pas ce qu’il vous faut. En cas de doute, utilisez un bouton d’outil.

Une variante du bouton de commande est le bouton de menu. Ceux-ci ne proposent pas une seule commande, mais plusieurs, car lorsqu’on clique dessus, ils affichent un menu d’options. Utilisez la méthode setMenu() pour associer un menu contextuel à un bouton.

Il existe d’autres types de boutons : les boutons d’option (voir QRadioButton) et les cases à cocher (voir QCheckBox).

Dans Qt, la classe de base ` QAbstractButton ` fournit la plupart des modes et autres interfaces de programmation, tandis que `QPushButton` fournit la logique d’interface graphique. Consultez ` QAbstractButton ` pour plus d’informations sur l’API.