QButtonGroup Class
La classe QButtonGroup fournit un conteneur permettant d'organiser des groupes de widgets de boutons. En savoir plus...
| En-tête : | #include <QButtonGroup> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | 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 des 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 plutôt les états de chacun des boutons du groupe.
Un groupe de boutons de type « exclusive » désactive tous les boutons cochables (à bascule) à l’exception de celui sur lequel l’utilisateur a cliqué. Par défaut, un groupe de boutons est exclusif. Les boutons d’un groupe de boutons sont généralement des boutons à case à cocher QPushButton, des boutons à case à cocher multiples QCheckBox(généralement pour les groupes de boutons non exclusifs) ou des boutons à case à cocher multiples QRadioButton. Si vous créez un groupe de boutons exclusif, vous devez vous assurer que l’un des boutons du groupe est coché au départ ; sinon, le groupe se trouvera initialement dans un état où aucun bouton n’est coché.
Un bouton peut être ajouté au groupe à l’aide de ` addButton()` et supprimé à l’aide de ` removeButton()`. Si le groupe est exclusif, le bouton actuellement coché est accessible via ` checkedButton()`. Lorsqu’un bouton est cliqué, le signal ` buttonClicked()` est émis ; pour un bouton cochable appartenant à un groupe exclusif, cela signifie que le bouton a été coché. La liste des boutons du groupe est renvoyée par la fonction ` buttons()`.
De plus, QButtonGroup permet d’établir une correspondance entre des entiers et des boutons. Vous pouvez attribuer un identifiant entier à un bouton à l’aide de ` setId()` et le récupérer à l’aide de ` id()`. L’identifiant du bouton actuellement coché est accessible via ` 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 ». Le mécanisme de mappage a pour but 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é détermine si le groupe de boutons est exclusif
Si cette propriété est définie sur « true », un seul bouton du groupe peut être coché à un moment donné. L'utilisateur peut cliquer sur n'importe quel bouton pour le cocher ; ce bouton remplacera alors le bouton coché existant au sein du groupe.
Dans un groupe exclusif, l’utilisateur ne peut pas décocher le bouton actuellement sélectionné en cliquant dessus ; il doit plutôt cliquer sur un autre bouton du groupe pour définir le nouveau bouton sélectionné pour ce groupe.
Par défaut, cette propriété est définie sur « true ».
Fonctions d’accès :
| bool | exclusive() const |
| void | setExclusive(bool) |
Documentation sur les fonctions membres
[explicit] QButtonGroup::QButtonGroup(QObject *parent = nullptr)
Crée un nouveau groupe de boutons vide avec l'parent spécifiée.
Voir également addButton() et setExclusive().
[virtual noexcept] QButtonGroup::~QButtonGroup()
Supprime le groupe de boutons.
void QButtonGroup::addButton(QAbstractButton *button, int id = -1)
Ajoute l'button spécifiée au groupe de boutons. Si id vaut -1, un identifiant sera attribué au bouton. Les identifiants attribués automatiquement sont toujours négatifs, en commençant par -2. Si vous attribuez vos propres identifiants, utilisez des valeurs positives pour éviter tout conflit.
Voir également removeButton() et buttons().
QAbstractButton *QButtonGroup::button(int id) const
Renvoie le bouton dont l'id est spécifiée, ou nullptr si aucun bouton de ce type n'existe.
[signal] void QButtonGroup::buttonClicked(QAbstractButton *button)
Ce signal est émis lorsqu'on clique sur l'button indiquée. Un bouton est considéré comme cliqué lorsqu'on appuie dessus puis qu'on le relâche, lorsqu'on tape sa touche de raccourci, ou lorsque les méthodes QAbstractButton::click() ou QAbstractButton::animateClick() sont appelées par programmation.
Voir également checkedButton() et QAbstractButton::clicked().
[signal] void QButtonGroup::buttonPressed(QAbstractButton *button)
Ce signal est émis lorsque l'button on indiquée est enfoncée.
Voir également QAbstractButton::pressed().
[signal] void QButtonGroup::buttonReleased(QAbstractButton *button)
Ce signal est émis lorsque l'button, indiquée, est relâchée.
Voir aussi QAbstractButton::released().
[signal] void QButtonGroup::buttonToggled(QAbstractButton *button, bool checked)
Ce signal est émis lorsque l'button on indiquée est modifiée. La valeur « checked » est vraie si le bouton est coché, et fausse s'il n'est pas coché.
Voir également QAbstractButton::toggled().
QList<QAbstractButton *> QButtonGroup::buttons() const
Renvoie la liste des boutons du groupe de boutons. Cette liste peut être vide.
Voir également addButton() et removeButton().
QAbstractButton *QButtonGroup::checkedButton() const
Renvoie le bouton coché du groupe de boutons, ou ` nullptr ` si aucun bouton n'est coché.
Voir aussi buttonClicked().
int QButtonGroup::checkedId() const
Renvoie l'identifiant de la fonction ` checkedButton()`, ou -1 si aucun bouton n'est coché.
Voir aussi setId().
int QButtonGroup::id(QAbstractButton *button) const
Renvoie l'identifiant de l'élément « button » spécifié, ou -1 si ce bouton n'existe pas.
Voir aussi setId().
[signal] void QButtonGroup::idClicked(int id)
Ce signal est émis lorsqu'on clique sur un bouton dont l'id est celle indiquée.
Voir également checkedButton() et QAbstractButton::clicked().
[signal] void QButtonGroup::idPressed(int id)
Ce signal est émis lorsqu'un bouton présentant l'id indiquée est enfoncé.
Voir également QAbstractButton::pressed().
[signal] void QButtonGroup::idReleased(int id)
Ce signal est émis lorsqu'un bouton dont l'id est spécifiée est relâché.
Voir également QAbstractButton::released().
[signal] void QButtonGroup::idToggled(int id, bool checked)
Ce signal est émis lorsqu'un bouton présentant l'id spécifiée est activé ou désactivé. La valeur « checked » est vraie si le bouton est coché, et fausse s'il ne l'est pas.
Voir également QAbstractButton::toggled().
void QButtonGroup::removeButton(QAbstractButton *button)
Supprime l'button on indiquée du groupe de boutons.
Voir également addButton() et buttons().
void QButtonGroup::setId(QAbstractButton *button, int id)
Définit l'id pour l'button spécifié. Notez que id ne peut pas être égal à -1.
Voir également 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.
