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 présentent généralement à l'utilisateur un choix "un parmi plusieurs". Dans un groupe de boutons radio, un seul bouton radio à la fois peut être coché ; si l'utilisateur sélectionne un autre bouton, le bouton précédemment sélectionné est désactivé.

Les boutons radio sont autoexclusifs par défaut. Si l'option auto-exclusif 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 les boutons radio qui appartiennent au même widget parent, placez-les dans un site 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 fois que le bouton change d'état. Utilisez isChecked() pour savoir 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 avec setIcon(). Le texte peut être défini dans le constructeur ou avec setText(). 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 :

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

Dans cet exemple, le raccourci est Alt+c. Voir la documentation de QShortcut pour plus de détails. Pour afficher une esperluette, utilisez '&&'.

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