QButtonGroup Class
La classe QButtonGroup fournit un conteneur permettant d'organiser des groupes de boutons. Plus d'informations...
| En-tête : | #include <QButtonGroup> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Héritages : | QObject |
Propriétés
- exclusive : bool
Fonctions publiques
| QButtonGroup(QObject *parent = nullptr) | |
| virtual | ~QButtonGroup() |
| void | addButton(QAbstractButton *button, int id = -1) |
| QAbstractButton * | button(int id) const |
| QList<QAbstractButton *> | buttons() const |
| QAbstractButton * | checkedButton() const |
| int | checkedId() const |
| bool | exclusive() const |
| int | id(QAbstractButton *button) const |
| void | removeButton(QAbstractButton *button) |
| void | setExclusive(bool) |
| void | setId(QAbstractButton *button, int id) |
Signaux
| void | buttonClicked(QAbstractButton *button) |
| void | buttonPressed(QAbstractButton *button) |
| void | buttonReleased(QAbstractButton *button) |
| void | buttonToggled(QAbstractButton *button, bool checked) |
| void | idClicked(int id) |
| void | idPressed(int id) |
| void | idReleased(int id) |
| void | idToggled(int id, bool checked) |
Description détaillée
QButtonGroup fournit un conteneur abstrait dans lequel les widgets de boutons peuvent être placés. Il ne fournit pas de représentation visuelle de ce conteneur (voir QGroupBox pour un widget conteneur), mais gère les états de chacun des boutons du groupe.
Un groupe de boutons exclusive désactive tous les boutons vérifiables (à bascule) à l'exception de celui qui a été cliqué. Par défaut, un groupe de boutons est exclusif. Les boutons d'un groupe de boutons sont généralement des boutons contrôlables QPushButtons, QCheckBoxes (normalement pour les groupes de boutons non exclusifs) ou QRadioButtons. Si vous créez un groupe de boutons exclusif, vous devez vous assurer que l'un des boutons du groupe est initialement contrôlé ; sinon, le groupe sera initialement dans un état où aucun bouton n'est contrôlé.
Un bouton peut être ajouté au groupe avec addButton() et supprimé avec removeButton(). Si le groupe est exclusif, le bouton actuellement coché est disponible avec checkedButton(). Si un bouton est cliqué, le signal buttonClicked() est émis ; pour un bouton vérifiable dans un groupe exclusif, cela signifie que le bouton a été vérifié. La liste des boutons du groupe est renvoyée par buttons().
En outre, QButtonGroup peut établir une correspondance entre les entiers et les boutons. Vous pouvez attribuer un identifiant entier à un bouton avec setId(), et le récupérer avec id(). L'identifiant du bouton actuellement coché est disponible avec checkedId(), et il existe un signal idClicked() qui émet l'identifiant du bouton. L'identifiant -1 est réservé par QButtonGroup pour signifier "aucun bouton de ce type". L'objectif du mécanisme de mappage est de simplifier la représentation des valeurs d'énumération dans une interface utilisateur.
Voir également QGroupBox, QPushButton, QCheckBox, et QRadioButton.
Documentation sur les propriétés
exclusive : bool
Cette propriété indique si le groupe de boutons est exclusif
Si cette propriété vaut true, un seul bouton du groupe peut être contrôlé à un moment donné. L'utilisateur peut cliquer sur n'importe quel bouton pour le cocher, et ce bouton remplacera le bouton existant en tant que bouton coché dans le groupe.
Dans un groupe exclusif, l'utilisateur ne peut pas décocher le bouton actuellement coché en cliquant dessus ; il doit cliquer sur un autre bouton du groupe pour définir le nouveau bouton coché pour ce groupe.
Par défaut, cette propriété est true.
Fonctions d'accès :
| bool | exclusive() const |
| void | setExclusive(bool) |
Documentation des fonctions membres
[explicit] QButtonGroup::QButtonGroup(QObject *parent = nullptr)
Construit un nouveau groupe de boutons vide avec l'adresse parent.
Voir aussi addButton() et setExclusive().
[virtual noexcept] QButtonGroup::~QButtonGroup()
Détruit le groupe de boutons.
void QButtonGroup::addButton(QAbstractButton *button, int id = -1)
Ajoute le bouton button au groupe de boutons. Si id vaut -1, un identifiant sera attribué au bouton. Les identifiants attribués automatiquement sont garantis négatifs, à partir de -2. Si vous attribuez vos propres identifiants, utilisez des valeurs positives pour éviter les conflits.
Voir aussi removeButton() et buttons().
QAbstractButton *QButtonGroup::button(int id) const
Renvoie le bouton avec la valeur spécifiée id, ou nullptr s'il n'existe pas de bouton de ce type.
[signal] void QButtonGroup::buttonClicked(QAbstractButton *button)
Ce signal est émis lorsque le bouton button est cliqué. Un bouton est cliqué lorsqu'il est pressé puis relâché, lorsque sa touche de raccourci est tapée ou lorsque QAbstractButton::click() ou QAbstractButton::animateClick() est appelé par programme.
Voir également checkedButton() et QAbstractButton::clicked().
[signal] void QButtonGroup::buttonPressed(QAbstractButton *button)
Ce signal est émis lorsque l'on appuie sur le bouton button.
Voir aussi QAbstractButton::pressed().
[signal] void QButtonGroup::buttonReleased(QAbstractButton *button)
Ce signal est émis lorsque l'adresse button est libérée.
Voir aussi QAbstractButton::released().
[signal] void QButtonGroup::buttonToggled(QAbstractButton *button, bool checked)
Ce signal est émis lorsque le bouton button est activé. checked est vrai si le bouton est coché ou faux s'il est décoché.
Voir aussi QAbstractButton::toggled().
QList<QAbstractButton *> QButtonGroup::buttons() const
Renvoie la liste des boutons du groupe de boutons. Elle peut être vide.
Voir aussi addButton() et removeButton().
QAbstractButton *QButtonGroup::checkedButton() const
Renvoie le bouton coché du groupe de boutons, ou nullptr si aucun bouton n'est coché.
Voir également buttonClicked().
int QButtonGroup::checkedId() const
Renvoie l'identifiant du bouton checkedButton(), ou -1 si aucun bouton n'est coché.
Voir aussi setId().
int QButtonGroup::id(QAbstractButton *button) const
Renvoie l'identifiant du bouton spécifié button, ou -1 s'il n'existe pas de bouton de ce type.
Voir aussi setId().
[signal] void QButtonGroup::idClicked(int id)
Ce signal est émis lorsqu'un bouton portant le numéro id est cliqué.
Voir aussi checkedButton() et QAbstractButton::clicked().
[signal] void QButtonGroup::idPressed(int id)
Ce signal est émis lorsqu'un bouton portant le numéro id est enfoncé.
Voir aussi QAbstractButton::pressed().
[signal] void QButtonGroup::idReleased(int id)
Ce signal est émis lorsqu'un bouton portant le numéro id est relâché.
Voir aussi QAbstractButton::released().
[signal] void QButtonGroup::idToggled(int id, bool checked)
Ce signal est émis lorsqu'un bouton portant le numéro id est activé. checked est vrai si le bouton est coché ou faux s'il est décoché.
Voir aussi QAbstractButton::toggled().
void QButtonGroup::removeButton(QAbstractButton *button)
Supprime le site button du groupe de boutons.
Voir aussi addButton() et buttons().
void QButtonGroup::setId(QAbstractButton *button, int id)
Définit l'adresse id pour l'adresse button spécifiée. Notez que id ne peut pas être -1.
Voir aussi id().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
