QActionGroup Class

Documentation des fonctions membres

[explicit] QActionGroup::QActionGroup(QObject *parent)

Crée un groupe d'actions pour l'objet ` parent `.

Par défaut, le groupe d’actions est exclusif. Appelez ` setExclusive(false)` pour rendre le groupe d’actions non exclusif. Pour rendre le groupe exclusif tout en permettant de désélectionner l’action active, appelez plutôt ` setExclusionPolicy(QActionGroup::ExclusionPolicy::ExclusiveOptional)`

[virtual noexcept] QActionGroup::~QActionGroup()

Supprime le groupe d'actions.

QList<QAction *> QActionGroup::actions() const

Renvoie la liste des actions de ce groupe. Elle peut être vide.

QAction *QActionGroup::addAction(QAction *action)

Ajoute l'action e à ce groupe, puis le renvoie.

En règle générale, une action est ajoutée à un groupe en la créant avec ce groupe comme parent ; cette fonction n’est donc généralement pas utilisée.

Voir aussi QAction::setActionGroup().

QAction *QActionGroup::addAction(const QString &text)

Crée et renvoie une action avec l'text. L'action nouvellement créée est une action enfant de ce groupe d'actions.

En règle générale, une action est ajoutée à un groupe en la créant avec ce groupe comme parent ; cette fonction n’est donc généralement pas utilisée.

Voir également QAction::setActionGroup().

QAction *QActionGroup::addAction(const QIcon &icon, const QString &text)

Crée et renvoie une action avec un « text » et un « icon ». L'action nouvellement créée est une action enfant de ce groupe d'actions.

En règle générale, une action est ajoutée à un groupe en la créant avec ce groupe comme parent ; cette fonction n’est donc généralement pas utilisée.

Voir également QAction::setActionGroup().

QAction *QActionGroup::checkedAction() const

Renvoie l'action actuellement sélectionnée dans le groupe, ou ` nullptr ` si aucune n'est sélectionnée.

[signal] void QActionGroup::hovered(QAction *action)

Ce signal est émis lorsque l'action donnée dans le groupe d'actions est mise en surbrillance par l'utilisateur ; par exemple, lorsque l'utilisateur survole une option de menu ou un bouton de la barre d'outils avec le curseur, ou lorsqu'il appuie sur la combinaison de touches de raccourci d'une action.

Voir aussi QAction::activate().

bool QActionGroup::isExclusive() const

Renvoie « true » si le groupe est exclusif

Le groupe est exclusif si l’ ExclusionPolicy e est « Exclusive » ou « ExclusionOptional ».

void QActionGroup::removeAction(QAction *action)

Supprime l'action de ce groupe. L'action n'aura donc plus de parent.

Voir aussi ` QAction::setActionGroup()`.

[slot] void QActionGroup::setDisabled(bool b)

Il s'agit d'une fonction pratique pour la propriété ` enabled `, utile pour les connexions signaux-slots. Si ` b ` est vrai, le groupe d'actions est désactivé ; dans le cas contraire, il est activé.

[slot] void QActionGroup::setExclusive(bool b)

Activer ou désactiver la vérification des exclusions de groupe

Il s'agit d'une méthode pratique qui appelle setExclusionPolicy(ExclusionPolicy::Exclusive) lorsque b est vrai, sinon setExclusionPolicy(QActionGroup::ExclusionPolicy::None).

Voir également isExclusive() et QActionGroup::exclusionPolicy.

[signal] void QActionGroup::triggered(QAction *action)

Ce signal est émis lorsque l'action, dans le groupe d'actions, est activée par l'utilisateur ; par exemple, lorsque l'utilisateur clique sur une option de menu ou sur un bouton de la barre d'outils, ou encore lorsqu'il appuie sur la combinaison de touches de raccourci d'une action.

Connectez-vous à ce signal pour les actions de commande.

Voir également ` QAction::activate()`