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 !