QRadioButton Class

Description détaillée

Un QRadioButton est un bouton d'option qui peut être activé (coché) ou désactivé (décoché). Les boutons radio proposent généralement à l'utilisateur un choix parmi plusieurs options. Dans un groupe de boutons radio, un seul bouton radio peut être coché à la fois ; si l'utilisateur sélectionne un autre bouton, le bouton précédemment sélectionné est désactivé.

Les boutons radio sont autoExclusive par défaut. Si l'auto-exclusivité est activée, les boutons radio appartenant au même widget parent se comportent comme s'ils faisaient partie du même groupe de boutons exclusifs. Si vous avez besoin de plusieurs groupes de boutons exclusifs pour des boutons radio appartenant au même widget parent, placez-les dans un QButtonGroup.

Chaque fois qu’un bouton est activé ou désactivé, il émet le signal ` toggled()`. Connectez-vous à ce signal si vous souhaitez déclencher une action à chaque changement d’état du bouton. Utilisez ` isChecked()` pour vérifier si un bouton particulier est sélectionné.

Tout comme QPushButton, un bouton radio affiche du texte et, éventuellement, une petite icône. L’icône est définie à l’aide de setIcon(). Le texte peut être défini dans le constructeur ou à l’aide de setText(). Un raccourci clavier peut être spécifié en faisant précéder le caractère souhaité d’un signe « & » dans le texte. Par exemple :

QRadioButton *button = new QRadioButton("Search from the &cursor", this);

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

Membres hérités importants : text(), setText(), text(), setDown(), isDown(), autoRepeat(), group(), setAutoRepeat(), toggle(), pressed(), released(), clicked() et toggled().