QPushButton Class

Description détaillée

Le bouton-poussoir, ou bouton de commande, est peut-être le widget le plus couramment utilisé dans une interface utilisateur graphique. Il suffit d'appuyer (cliquer) sur un bouton pour ordonner à l'ordinateur d'effectuer une action ou de répondre à une question. Les boutons typiques sont OK, Appliquer, Annuler, Fermer, Oui, Non et Aide.

Un bouton de commande est rectangulaire et affiche généralement un texte décrivant son action. Une touche de raccourci peut être spécifiée en faisant précéder le caractère préféré d'une esperluette dans le texte. Par exemple, dans cet exemple, le raccourci est Alt :

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

Dans cet exemple, le raccourci est Alt+D. Pour plus de détails, consultez la documentation de QShortcut (pour afficher une esperluette, utilisez "&&").

Les boutons poussoirs affichent une étiquette textuelle et, éventuellement, une petite icône. Ces éléments peuvent être définis à l'aide des constructeurs et modifiés ultérieurement à l'aide de setText() et setIcon(). Si le bouton est désactivé, l'apparence du texte et de l'icône sera manipulée en fonction du style de l'interface graphique pour que le bouton ait l'air "désactivé".

Un bouton poussoir émet le signal clicked() lorsqu'il est activé par la souris, la barre d'espacement ou un raccourci clavier. Il faut se connecter à ce signal pour effectuer l'action du bouton. Les boutons poussoirs émettent également des signaux moins courants, par exemple pressed() et released().

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

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

Le widget bouton étant si central, il s'est développé et a connu de nombreuses variations au cours de la dernière décennie. Le guide de style de Microsoft indique aujourd'hui une dizaine d'états différents pour les boutons poussoirs de Windows et le texte laisse entendre qu'il y en a des dizaines d'autres lorsque toutes les combinaisons de caractéristiques sont prises en considération.

Les modes ou états les plus importants sont les suivants

• Disponible ou non (grisé, désactivé).
• Bouton-poussoir standard, bouton-poussoir à bascule ou bouton de menu.
• Activé ou désactivé (uniquement pour les boutons-poussoirs à 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.
• Appuyé ou non.

En règle générale, utilisez un bouton poussoir 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 large et rectangulaire 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 du site QFileDialog) ne sont pas des boutons de commande, mais des boutons d'outil. 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.

Le bouton de menu est une variante du bouton de commande. Ceux-ci ne fournissent pas une seule commande, mais plusieurs, puisque lorsqu'on clique dessus, un menu d'options s'affiche. Utilisez la méthode setMenu() pour associer un menu contextuel à un bouton de commande.

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

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