QActionGroup Class

Documentation des fonctions membres

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

Construit un groupe d'action pour l'objet parent.

Le groupe d'action est exclusif par défaut. Appelez setExclusive(false) pour rendre le groupe d'action non exclusif. Pour rendre le groupe exclusif mais permettre de décocher l'action active, appelez plutôt setExclusionPolicy(QActionGroup::ExclusionPolicy::ExclusiveOptional).

[virtual noexcept] QActionGroup::~QActionGroup()

Détruit le groupe d'action.

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

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

QAction *QActionGroup::addAction(QAction *action)

Ajoute le site action à ce groupe et le renvoie.

Normalement, une action est ajoutée à un groupe en la créant avec le 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 text. L'action nouvellement créée est un enfant de ce groupe d'actions.

Normalement, une action est ajoutée à un groupe en la créant avec le groupe comme parent, cette fonction n'est donc pas utilisée habituellement.

Voir également QAction::setActionGroup().

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

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

Normalement, une action est ajoutée à un groupe en la créant avec le groupe comme parent, cette fonction n'est donc pas utilisée habituellement.

Voir aussi QAction::setActionGroup().

QAction *QActionGroup::checkedAction() const

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

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

Ce signal est émis lorsque le site action du groupe d'actions est mis en évidence par l'utilisateur ; par exemple, lorsque l'utilisateur fait une pause avec le curseur au-dessus d'une option de menu ou d'un bouton de la barre d'outils, ou lorsqu'il appuie sur une combinaison de touches de raccourci d'une action.

Voir également QAction::activate().

bool QActionGroup::isExclusive() const

Retourne vrai si le groupe est exclusif

Le groupe est exclusif si l'adresse ExclusionPolicy est soit Exclusive, soit ExclusionOptionnelle.

void QActionGroup::removeAction(QAction *action)

Supprime le site action de ce groupe. L'action n'aura pas de parent comme résultat.

Voir aussi QAction::setActionGroup().

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

Il s'agit d'une fonction de commodité pour la propriété enabled, utile pour les connexions signaux-emplacements. Si b est vrai, le groupe d'action est désactivé ; sinon, il est activé.

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

Activer ou désactiver le contrôle de l'exclusion des groupes

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

Voir aussi isExclusive() et QActionGroup::exclusionPolicy.

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

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

Se connecter à ce signal pour les actions de commande.

Voir également QAction::activate().