              
Q3ActionGroup Class Reference |
| Q3ActionGroup ( QObject * parent, const char * name = 0 ) | |
| Q3ActionGroup ( QObject * parent, const char * name, bool exclusive ) | |
| ~Q3ActionGroup () | |
| void | add ( Q3Action * action ) |
| void | addSeparator () |
| void | insert ( Q3Action * action ) |
| bool | isExclusive () const |
| void | setExclusive ( bool ) |
| void | setUsesDropDown ( bool enable ) |
| bool | usesDropDown () const |
Reimplemented Public Functions
| virtual bool | addTo ( QWidget * w ) |
| virtual bool | removeFrom ( QWidget * w ) |
| virtual void | setEnabled ( bool enable ) |
| virtual void | setIconSet ( const QIcon & icon ) |
| virtual void | setMenuText ( const QString & text ) |
| virtual void | setOn ( bool on ) |
| virtual void | setText ( const QString & txt ) |
| virtual void | setToggleAction ( bool toggle ) |
| virtual void | setToolTip ( const QString & text ) |
| virtual void | setVisible ( bool visible ) |
| virtual void | setWhatsThis ( const QString & text ) |
Signals
| void | activated ( Q3Action * action ) |
| void | selected ( Q3Action * action ) |
Protected Functions
| virtual void | addedTo ( QWidget * actionWidget, QWidget * container, Q3Action * a ) |
| virtual void | addedTo ( int index, Q3PopupMenu * menu, Q3Action * a ) |
Reimplemented Protected Functions
| virtual void | addedTo ( QWidget * actionWidget, QWidget * container ) |
| virtual void | addedTo ( int index, Q3PopupMenu * menu ) |
| virtual void | childEvent ( QChildEvent * e ) |
Additional Inherited Members
- 6 public slots inherited from Q3Action
- 1 public slot inherited from QObject
- 5 static public members inherited from QObject
Detailed Description
The Q3ActionGroup class groups actions together.
In some situations it is useful to group actions together. For example, if you have a left justify action, a right justify action and a center action, only one of these actions should be active at any one time, and one simple way of achieving this is to group the actions together in an action group.
An action group can also be added to a menu or a toolbar as a single unit, with all the actions within the action group appearing as separate menu options and toolbar buttons.
The actions in an action group emit their activated() (and for toggle actions, toggled()) signals as usual.
The setExclusive() function is used to ensure that only one action is active at any one time: it should be used with actions which have their toggleAction set to true.
Action group actions appear as individual menu options and toolbar buttons. For exclusive action groups use setUsesDropDown() to display the actions in a subwidget of any widget the action group is added to. For example, the actions would appear in a combobox in a toolbar or as a submenu in a menu.
Actions can be added to an action group using add(), but normally they are added by creating the action with the action group as parent. Actions can have separators dividing them using addSeparator(). Action groups are added to widgets with addTo().
Property Documentation
exclusive : bool
This property holds whether the action group does exclusive toggling.
If exclusive is true only one toggle action in the action group can ever be active at any one time. If the user chooses another toggle action in the group the one they chose becomes active and the one that was active becomes inactive.
Access functions:
| bool | isExclusive () const |
| void | setExclusive ( bool ) |
See also Q3Action::toggleAction.
usesDropDown : bool
This property holds whether the group's actions are displayed in a subwidget of the widgets the action group is added to.
Exclusive action groups added to a toolbar display their actions in a combobox with the action's Q3Action::text and Q3Action::iconSet properties shown. Non-exclusive groups are represented by a tool button showing their Q3Action::iconSet and text() property.
In a popup menu the member actions are displayed in a submenu.
Changing usesDropDown only affects subsequent calls to addTo().
This property's default is false.
Access functions:
| bool | usesDropDown () const |
| void | setUsesDropDown ( bool enable ) |
Member Function Documentation
Q3ActionGroup::Q3ActionGroup ( QObject * parent, const char * name = 0 )
Constructs an action group called name, with parent parent.
The action group is exclusive by default. Call setExclusive(false) to make the action group non-exclusive.
Q3ActionGroup::Q3ActionGroup ( QObject * parent, const char * name, bool exclusive )
Constructs an action group called name, with parent parent.
If exclusive is true only one toggle action in the group will ever be active.
See also exclusive.
Q3ActionGroup::~Q3ActionGroup ()
Destroys the object and frees allocated resources.
void Q3ActionGroup::activated ( Q3Action * action ) [signal]
This signal is emitted from groups when one of its actions gets activated.
The argument is the action which was activated.
See also setExclusive(), isOn(), and Q3Action::toggled().
void Q3ActionGroup::add ( Q3Action * action )
Adds action action to this group.
Normally an action is added to a group by creating it with the group as parent, so this function is not usually used.
See also addTo().
void Q3ActionGroup::addSeparator ()
Adds a separator to the group.
bool Q3ActionGroup::addTo ( QWidget * w ) [virtual]
Reimplemented from Q3Action::addTo().
Adds this action group to the widget w.
If isExclusive() is false or usesDropDown() is false, the actions within the group are added to the widget individually. For example, if the widget is a menu, the actions will appear as individual menu options, and if the widget is a toolbar, the actions will appear as toolbar buttons.
If both isExclusive() and usesDropDown() are true, the actions are presented either in a combobox (if w is a toolbar) or in a submenu (if w is a menu).
All actions should be added to the action group before the action group is added to the widget. If actions are added to the action group after the action group has been added to the widget these later actions will not appear.
See also setExclusive(), setUsesDropDown(), and removeFrom().
void Q3ActionGroup::addedTo ( QWidget * actionWidget, QWidget * container, Q3Action * a ) [virtual protected]
This function is called from the addTo() function when it has created a widget (actionWidget) for the child action a in the container.
void Q3ActionGroup::addedTo ( int index, Q3PopupMenu * menu, Q3Action * a ) [virtual protected]
This is an overloaded function.
This function is called from the addTo() function when it has created a menu item for the child action at the index position index in the popup menu menu.
void Q3ActionGroup::addedTo ( QWidget * actionWidget, QWidget * container ) [virtual protected]
Reimplemented from Q3Action::addedTo().
This is an overloaded function.
This function is called from the addTo() function when it has created a widget (actionWidget) in the container.
void Q3ActionGroup::addedTo ( int index, Q3PopupMenu * menu ) [virtual protected]
Reimplemented from Q3Action::addedTo().
This is an overloaded function.
This function is called from the addTo() function when it has created a menu item at the index position index in the popup menu menu.
void Q3ActionGroup::childEvent ( QChildEvent * e ) [virtual protected]
Reimplemented from QObject::childEvent().
void Q3ActionGroup::insert ( Q3Action * action )
Use add(action) instead.
bool Q3ActionGroup::removeFrom ( QWidget * w ) [virtual]
Reimplemented from Q3Action::removeFrom().
void Q3ActionGroup::selected ( Q3Action * action ) [signal]
This signal is emitted from exclusive groups when toggle actions change state.
The argument is the action whose state changed to "on".
See also setExclusive(), isOn(), and Q3Action::toggled().
void Q3ActionGroup::setEnabled ( bool enable ) [virtual]
Reimplemented from Q3Action::setEnabled().
void Q3ActionGroup::setIconSet ( const QIcon & icon ) [virtual]
Reimplemented from Q3Action::setIconSet().
void Q3ActionGroup::setMenuText ( const QString & text ) [virtual]
Reimplemented from Q3Action::setMenuText().
void Q3ActionGroup::setOn ( bool on ) [virtual]
Reimplemented from Q3Action::setOn().
void Q3ActionGroup::setText ( const QString & txt ) [virtual]
Reimplemented from Q3Action::setText().
void Q3ActionGroup::setToggleAction ( bool toggle ) [virtual]
Reimplemented from Q3Action::setToggleAction().
void Q3ActionGroup::setToolTip ( const QString & text ) [virtual]
Reimplemented from Q3Action::setToolTip().
void Q3ActionGroup::setVisible ( bool visible ) [virtual]
Reimplemented from Q3Action::setVisible().
void Q3ActionGroup::setWhatsThis ( const QString & text ) [virtual]
Reimplemented from Q3Action::setWhatsThis().
Best Of
Actualités les plus lues
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 64
- 2017 : un quinquennat pour une nouvelle version du C++ ? Possible, selon Herb Sutter 5
- Créer des applications avec un style Metro avec Qt, exemples en QML et C++, un article du blog Digia traduit par Thibaut Cuvelier 0
- Orientation de l'écran en QML, un article de Christophe Dumez traduit par Thibaut Cuvelier 0
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 64
- Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
- Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
- BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
- Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
- Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
- La rubrique Qt a besoin de vous ! 1
- Linus Torvalds : le "C++ est un langage horrible", en justifiant le choix du C pour le système de gestion de version Git 100
- Comment prendre en compte l'utilisateur dans vos applications ? Pour un développeur, « 90 % des utilisateurs sont des idiots » 229
- Quel est LE livre que tout développeur doit lire absolument ? Celui qui vous a le plus marqué et inspiré 96
- Apple cède et s'engage à payer des droits à Nokia, le conflit des brevets entre les deux firmes s'achève 158
- Nokia porte à nouveau plainte contre Apple pour violation de sept nouveaux brevets 158
- Quel est le code dont vous êtes le plus fier ? Pourquoi l'avez-vous écrit ? Et pourquoi vous a-t-il donné autant de satisfaction ? 83
- Le Draft final de la norme C++ 0X validé 181
Communauté
Ressources
- cours et tutoriels Qt
- F.A.Q. Qt : questions et réponses
- Qt Quarterly, Qt Labs et Qt DevNet en français
- outils Qt
- sources Qt
- binaires Qt
- livres Qt et critiques
- La documentation de Qt en français : classes, concepts et modules
- 3 certifications Qt
Liens utiles
Contact
- Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).
Qt dans le magazine
| Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. | Qt 4.6 | |
| Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD. | ||
| Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP ! | ||
Copyright © 2000-2012 - www.developpez.com