              
QToolBar Class Reference |
|
|
Public Functions
| QToolBar ( const QString & title, QWidget * parent = 0 ) | |
| QToolBar ( QWidget * parent = 0 ) | |
| ~QToolBar () | |
| QAction * | actionAt ( const QPoint & p ) const |
| QAction * | actionAt ( int x, int y ) const |
| void | addAction ( QAction * action ) |
| QAction * | addAction ( const QString & text ) |
| QAction * | addAction ( const QIcon & icon, const QString & text ) |
| QAction * | addAction ( const QString & text, const QObject * receiver, const char * member ) |
| QAction * | addAction ( const QIcon & icon, const QString & text, const QObject * receiver, const char * member ) |
| QAction * | addSeparator () |
| QAction * | addWidget ( QWidget * widget ) |
| Qt::ToolBarAreas | allowedAreas () const |
| void | clear () |
| QSize | iconSize () const |
| QAction * | insertSeparator ( QAction * before ) |
| QAction * | insertWidget ( QAction * before, QWidget * widget ) |
| bool | isAreaAllowed ( Qt::ToolBarArea area ) const |
| bool | isFloatable () const |
| bool | isFloating () const |
| bool | isMovable () const |
| Qt::Orientation | orientation () const |
| void | setAllowedAreas ( Qt::ToolBarAreas areas ) |
| void | setFloatable ( bool floatable ) |
| void | setMovable ( bool movable ) |
| void | setOrientation ( Qt::Orientation orientation ) |
| QAction * | toggleViewAction () const |
| Qt::ToolButtonStyle | toolButtonStyle () const |
| QWidget * | widgetForAction ( QAction * action ) const |
- 217 public functions inherited from QWidget
- 29 public functions inherited from QObject
- 13 public functions inherited from QPaintDevice
Public Slots
| void | setIconSize ( const QSize & iconSize ) |
| void | setToolButtonStyle ( Qt::ToolButtonStyle toolButtonStyle ) |
Signals
| void | actionTriggered ( QAction * action ) |
| void | allowedAreasChanged ( Qt::ToolBarAreas allowedAreas ) |
| void | iconSizeChanged ( const QSize & iconSize ) |
| void | movableChanged ( bool movable ) |
| void | orientationChanged ( Qt::Orientation orientation ) |
| void | toolButtonStyleChanged ( Qt::ToolButtonStyle toolButtonStyle ) |
| void | topLevelChanged ( bool topLevel ) |
Reimplemented Protected Functions
| virtual void | actionEvent ( QActionEvent * event ) |
| virtual void | changeEvent ( QEvent * event ) |
| virtual void | childEvent ( QChildEvent * event ) |
| virtual bool | event ( QEvent * event ) |
| virtual void | paintEvent ( QPaintEvent * event ) |
| virtual void | resizeEvent ( QResizeEvent * event ) |
- 37 protected functions inherited from QWidget
- 7 protected functions inherited from QObject
- 1 protected function inherited from QPaintDevice
Additional Inherited Members
- 4 static public members inherited from QWidget
- 5 static public members inherited from QObject
- 37 protected functions inherited from QWidget
- 7 protected functions inherited from QObject
- 1 protected function inherited from QPaintDevice
- 1 protected slot inherited from QWidget
Detailed Description
The QToolBar class provides a movable panel that contains a set of controls.
Toolbar buttons are added by adding actions, using addAction() or insertAction(). Groups of buttons can be separated using addSeparator() or insertSeparator(). If a toolbar button is not appropriate, a widget can be inserted instead using addWidget() or insertWidget(); examples of suitable widgets are QSpinBox, QDoubleSpinBox, and QComboBox. When a toolbar button is pressed it emits the actionTriggered() signal.
A toolbar can be fixed in place in a particular area (e.g. at the top of the window), or it can be movable (isMovable()) between toolbar areas; see allowedAreas() and isAreaAllowed().
When a toolbar is resized in such a way that it is too small to show all the items it contains, an extension button will appear as the last item in the toolbar. Pressing the extension button will pop up a menu containing the items that does not currently fit in the toolbar.
When a QToolBar is not a child of a QMainWindow, it looses the ability to populate the extension pop up with widgets added to the toolbar using addWidget(). Please use widget actions created by inheriting QWidgetAction and implementing QWidgetAction::createWidget() instead.
See also QToolButton, QMenu, QAction, and Application Example.
Property Documentation
allowedAreas : Qt::ToolBarAreas
This property holds areas where the toolbar may be placed.
The default is Qt::AllToolBarAreas.
This property only makes sense if the toolbar is in a QMainWindow.
Access functions:
| Qt::ToolBarAreas | allowedAreas () const |
| void | setAllowedAreas ( Qt::ToolBarAreas areas ) |
Notifier signal:
| void | allowedAreasChanged ( Qt::ToolBarAreas allowedAreas ) |
See also movable.
floatable : bool
This property holds whether the toolbar can be dragged and dropped as an independent window.
The default is true.
Access functions:
| bool | isFloatable () const |
| void | setFloatable ( bool floatable ) |
floating : const bool
This property holds whether the toolbar is an independent window.
By default, this property is true.
Access functions:
| bool | isFloating () const |
See also QWidget::isWindow().
iconSize : QSize
This property holds size of icons in the toolbar.
The default size is determined by the application's style and is derived from the QStyle::PM_ToolBarIconSize pixel metric. It is the maximum size an icon can have. Icons of smaller size will not be scaled up.
Access functions:
| QSize | iconSize () const |
| void | setIconSize ( const QSize & iconSize ) |
Notifier signal:
| void | iconSizeChanged ( const QSize & iconSize ) |
movable : bool
This property holds whether the user can move the toolbar within the toolbar area, or between toolbar areas.
By default, this property is true.
This property only makes sense if the toolbar is in a QMainWindow.
Access functions:
| bool | isMovable () const |
| void | setMovable ( bool movable ) |
Notifier signal:
| void | movableChanged ( bool movable ) |
See also allowedAreas.
orientation : Qt::Orientation
This property holds orientation of the toolbar.
The default is Qt::Horizontal.
This function should not be used when the toolbar is managed by QMainWindow. You can use QMainWindow::addToolBar() or QMainWindow::insertToolBar() if you wish to move a toolbar (that is already added to a main window) to another Qt::ToolBarArea.
Access functions:
| Qt::Orientation | orientation () const |
| void | setOrientation ( Qt::Orientation orientation ) |
Notifier signal:
| void | orientationChanged ( Qt::Orientation orientation ) |
toolButtonStyle : Qt::ToolButtonStyle
This property holds the style of toolbar buttons.
This property defines the style of all tool buttons that are added as QActions. Note that if you add a QToolButton with the addWidget() method, it will not get this button style.
The default is Qt::ToolButtonIconOnly.
Access functions:
| Qt::ToolButtonStyle | toolButtonStyle () const |
| void | setToolButtonStyle ( Qt::ToolButtonStyle toolButtonStyle ) |
Notifier signal:
| void | toolButtonStyleChanged ( Qt::ToolButtonStyle toolButtonStyle ) |
Member Function Documentation
QToolBar::QToolBar ( const QString & title, QWidget * parent = 0 )
Constructs a QToolBar with the given parent.
The given window title identifies the toolbar and is shown in the context menu provided by QMainWindow.
See also setWindowTitle().
QToolBar::QToolBar ( QWidget * parent = 0 )
Constructs a QToolBar with the given parent.
QToolBar::~QToolBar ()
Destroys the toolbar.
QAction * QToolBar::actionAt ( const QPoint & p ) const
Returns the action at point p. This function returns zero if no action was found.
See also QWidget::childAt().
QAction * QToolBar::actionAt ( int x, int y ) const
This is an overloaded function.
Returns the action at the point x, y. This function returns zero if no action was found.
void QToolBar::actionEvent ( QActionEvent * event ) [virtual protected]
Reimplemented from QWidget::actionEvent().
void QToolBar::actionTriggered ( QAction * action ) [signal]
This signal is emitted when an action in this toolbar is triggered. This happens when the action's tool button is pressed, or when the action is triggered in some other way outside the tool bar. The parameter holds the triggered action.
void QToolBar::addAction ( QAction * action )
This is an overloaded function.
Appends the action action to the toolbar's list of actions.
See also QMenu::addAction() and QWidget::addAction().
QAction * QToolBar::addAction ( const QString & text )
This is an overloaded function.
Creates a new action with the given text. This action is added to the end of the toolbar.
QAction * QToolBar::addAction ( const QIcon & icon, const QString & text )
This is an overloaded function.
Creates a new action with the given icon and text. This action is added to the end of the toolbar.
QAction * QToolBar::addAction ( const QString & text, const QObject * receiver, const char * member )
This is an overloaded function.
Creates a new action with the given text. This action is added to the end of the toolbar. The action's triggered() signal is connected to member in receiver.
QAction * QToolBar::addAction ( const QIcon & icon, const QString & text, const QObject * receiver, const char * member )
This is an overloaded function.
Creates a new action with the icon icon and text text. This action is added to the end of the toolbar. The action's triggered() signal is connected to member in receiver.
QAction * QToolBar::addSeparator ()
Adds a separator to the end of the toolbar.
See also insertSeparator().
QAction * QToolBar::addWidget ( QWidget * widget )
Adds the given widget to the toolbar as the toolbar's last item.
The toolbar takes ownership of widget.
If you add a QToolButton with this method, the tools bar's Qt::ToolButtonStyle will not be respected.
Note: You should use QAction::setVisible() to change the visibility of the widget. Using QWidget::setVisible(), QWidget::show() and QWidget::hide() does not work.
See also insertWidget().
void QToolBar::allowedAreasChanged ( Qt::ToolBarAreas allowedAreas ) [signal]
This signal is emitted when the collection of allowed areas for the toolbar is changed. The new areas in which the toolbar can be positioned are specified by allowedAreas.
See also allowedAreas.
void QToolBar::changeEvent ( QEvent * event ) [virtual protected]
Reimplemented from QWidget::changeEvent().
void QToolBar::childEvent ( QChildEvent * event ) [virtual protected]
Reimplemented from QObject::childEvent().
void QToolBar::clear ()
Removes all actions from the toolbar.
See also removeAction().
bool QToolBar::event ( QEvent * event ) [virtual protected]
Reimplemented from QObject::event().
void QToolBar::iconSizeChanged ( const QSize & iconSize ) [signal]
This signal is emitted when the icon size is changed. The iconSize parameter holds the toolbar's new icon size.
See also iconSize and QMainWindow::iconSize.
QAction * QToolBar::insertSeparator ( QAction * before )
Inserts a separator into the toolbar in front of the toolbar item associated with the before action.
See also addSeparator().
QAction * QToolBar::insertWidget ( QAction * before, QWidget * widget )
Inserts the given widget in front of the toolbar item associated with the before action.
Note: You should use QAction::setVisible() to change the visibility of the widget. Using QWidget::setVisible(), QWidget::show() and QWidget::hide() does not work.
See also addWidget().
bool QToolBar::isAreaAllowed ( Qt::ToolBarArea area ) const
Returns true if this toolbar is dockable in the given area; otherwise returns false.
void QToolBar::movableChanged ( bool movable ) [signal]
This signal is emitted when the toolbar becomes movable or fixed. If the toolbar can be moved, movable is true; otherwise it is false.
See also movable.
void QToolBar::orientationChanged ( Qt::Orientation orientation ) [signal]
This signal is emitted when the orientation of the toolbar changes. The new orientation is specified by the orientation given.
See also orientation.
void QToolBar::paintEvent ( QPaintEvent * event ) [virtual protected]
Reimplemented from QWidget::paintEvent().
void QToolBar::resizeEvent ( QResizeEvent * event ) [virtual protected]
Reimplemented from QWidget::resizeEvent().
QAction * QToolBar::toggleViewAction () const
Returns a checkable action that can be used to show or hide this toolbar.
The action's text is set to the toolbar's window title.
See also QAction::text and QWidget::windowTitle.
void QToolBar::toolButtonStyleChanged ( Qt::ToolButtonStyle toolButtonStyle ) [signal]
This signal is emitted when the tool button style is changed. The toolButtonStyle parameter holds the toolbar's new tool button style.
See also toolButtonStyle and QMainWindow::toolButtonStyle.
void QToolBar::topLevelChanged ( bool topLevel ) [signal]
This signal is emitted when the floating property changes. The topLevel parameter is true if the toolbar is now floating; otherwise it is false.
This function was introduced in Qt 4.6.
See also isWindow().
QWidget * QToolBar::widgetForAction ( QAction * action ) const
Returns the widget associated with the specified action.
This function was introduced in Qt 4.2.
See also addWidget().
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 44
- Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
- 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
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 44
- Microsoft ouvre aux autres compilateurs C++ AMP, la spécification pour la conception d'applications parallèles C++ utilisant le GPU 22
- Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
- RIM : « 13 % des développeurs ont gagné plus de 100 000 $ sur l'AppWord », Qt et open-source au menu du BlackBerry DevCon Europe 0
- 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
- 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
Le blog Digia au hasard
Déploiement d'applications Qt Commercial sur les tablettes Windows 8
Communauté
Ressources
- 91 cours et tutoriels Qt
- F.A.Q. Qt : 200 questions et réponses
- 48 Qt Quarterly, 35 Qt Labs et 22 Qt DevNet en français
- 43 outils Qt
- 99 sources Qt
- 26 binaires Qt
- 6 livres Qt et 9 critiques
- La documentation de Qt 4.7 en français : 157 classes, 70 concepts et 24 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