QActionGroup

La classe QActionGroup permet de regrouper des actions. Plus d'informations...

 #include <QActionGroup>

Héritage

Hérite de QObject.

Description détaillée

La classe QActionGroup permet de regrouper des actions.

Dans certaines situations il est utile de regrouper des actions. Par exemple, si vous avez une action Alignement à gauche, une action Alignement à droite, une action Justifier et une action Centrer, une seule de ces actions doit être active à la fois. Une façon simple d'y parvenir est de regrouper les actions dans un groupe d'actions.

Voici un exemple (extrait de l'exemple Menus) :

     alignmentGroup = new QActionGroup(this);
     alignmentGroup->addAction(leftAlignAct);
     alignmentGroup->addAction(rightAlignAct);
     alignmentGroup->addAction(justifyAct);
     alignmentGroup->addAction(centerAct);
     leftAlignAct->setChecked(true);

Nous créons ici un nouveau groupe d'actions. Étant donné que le groupe d'actions est exclusif par défaut, une seule des actions du groupe est active à la fois.

Un QActionGroup émet un signal triggered() lorsqu'une de ses actions est choisie. Chaque action dans un groupe d'actions émet normalement son signal triggered().

Comme précisé ci-dessus, un groupe d'actions est exclusif par défaut ; cela garantit qu'une seule action peut être active (cochée) à un moment donné. Si vous voulez grouper des actions activables sans les rendre exclusives, vous pouvez désactiver l'exclusivité en appelant setExclusive(false).

Les actions peuvent être ajoutées à un groupe d'actions en utilisant addAction(), mais il est habituellement plus pratique de spécifier un groupe au moment de la création des actions ; cela garantit que les actions seront automatiquement créées avec un parent. Les actions peuvent être séparées visuellement les unes des autres en ajoutant une action de séparation au groupe ; créez une action et utilisez la fonction setSeparator() de QAction pour la transformer en séparateur. Les groupes d'actions sont ajoutés aux widgets avec la fonction QWidget::addActions().

Voir aussi QAction.

Propriétés

enabled : bool

Cette propriété indique si le groupe d'actions est activé ou non.

Toutes les actions du groupe seront activées ou désactivées sauf celles qui ont été explicitement activées ou désactivées.

Fonction d'accès

bool isEnabled () const

void setEnabled ( bool )

Voir aussi QAction::setEnabled().

exclusive : bool

Cette propriété indique si le groupe d'actions est exclusif ou non.

Si exclusive est égal à true, une seule des actions activables (cochables) du groupe peut être active à un moment donné. Si l'utilisateur choisit une autre action du groupe, l'action choisie devient active et l'action précédemment active devient inactive.

Fonction d'accès

bool isExclusive () const

void setExclusive ( bool )

Voir aussi QAction::checkable.

visible : bool

Cette propriété indique si le groupe d'actions est visible ou non.

Chaque action du groupe sera dans l'état de visibilité du groupe sauf si elle a été explicitement cachée.

Fonction d'accès

bool isVisible () const

void setVisible ( bool )

Voir aussi QAction::setEnabled().

Fonctions membres

QActionGroup::QActionGroup ( QObject * parent )

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

Le groupe d'actions est exclusif par défaut. Appelez setExclusive(false) pour rendre le groupe non exclusif.

QActionGroup::~QActionGroup ()

Détruit le groupe d'actions.

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

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

QAction * QActionGroup::addAction ( QAction * action )

Ajoute action à ce groupe, et la renvoie.

En général une action est ajoutée à un groupe en la créant avec le groupe comme parent, donc cette fonction n'est que rarement utilisée.

Voir aussi QAction::setActionGroup().

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

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

En général une action est ajoutée à un groupe en la créant avec le groupe comme parent, donc cette fonction n'est que rarement utilisée.

Voir aussi QAction::setActionGroup().

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

Crée et renvoie une action avec le texte text et l'icône icon. L?action nouvellement créée est un enfant de ce groupe d'actions.

En général une action est ajoutée à un groupe en la créant avec le groupe comme parent, donc cette fonction n'est que rarement utilisée.

Voir aussi QAction::setActionGroup().

QAction * QActionGroup::checkedAction () const

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

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

Ce signal est émis lorsque l'action action du groupe d'actions est sélectionnée par l'utilisateur, par exemple si l'utilisateur place le pointeur sur une option de menu ou un bouton de barre d'outils, ou effectue la combinaison de touches du raccourci de l'action.

Voir aussi QAction::activate().

void QActionGroup::removeAction ( QAction * action )

Retire action de ce groupe. En conséquence, cette action n'aura plus de parent.

Voir aussi QAction::setActionGroup().

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

Fonction de commodité pour la modification de la propriété enabled, utile pour les connexions signal-slot. Si b est égal à true le groupe d'actions est désactivé, sinon il est activé.

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

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

Se connecter à ce signal pour traiter les actions correspondant à des commandes.

Voir aussi QAction::activate().

Remerciements

Merci à Ilya Diallo pour la traduction, ainsi qu'à Lo?c Leguay et Claude Leloup pour la relecture !