QToolBar Class
La classe QToolBar fournit un panneau mobile qui contient un ensemble de contrôles. Plus d'informations...
| En-tête : | #include <QToolBar> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Héritages : | QWidget |
Propriétés
|
|
Fonctions publiques
| QToolBar(QWidget *parent = nullptr) | |
| QToolBar(const QString &title, QWidget *parent = nullptr) | |
| virtual | ~QToolBar() |
| QAction * | actionAt(const QPoint &p) const |
| QAction * | actionAt(int x, int y) const |
| 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 |
Emplacements publics
| void | setIconSize(const QSize &iconSize) |
| void | setToolButtonStyle(Qt::ToolButtonStyle toolButtonStyle) |
Signaux
| 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) |
| void | visibilityChanged(bool visible) |
Fonctions protégées réimplémentées
| virtual void | actionEvent(QActionEvent *event) override |
| virtual void | changeEvent(QEvent *event) override |
| virtual bool | event(QEvent *event) override |
| virtual void | paintEvent(QPaintEvent *event) override |
Description détaillée
Une barre d'outils est généralement créée en appelant QMainWindow::addToolBar(const QString &title), mais elle peut également être ajoutée en tant que premier widget dans un QVBoxLayout, par exemple.
Les boutons de la barre d'outils sont ajoutés en ajoutant des actions, à l'aide de addAction() ou insertAction(). Les groupes de boutons peuvent être séparés à l'aide de addSeparator() ou insertSeparator(). Si un bouton de barre d'outils n'est pas approprié, un widget peut être inséré à la place en utilisant addWidget() ou insertWidget(). Les exemples de widgets appropriés sont QSpinBox, QDoubleSpinBox, et QComboBox. Lorsqu'un bouton de la barre d'outils est enfoncé, il émet le signal actionTriggered().
Une barre d'outils peut être fixée dans une zone particulière (par exemple, en haut de la fenêtre) ou peut être déplacée d'une zone à l'autre ; voir setMovable(), isMovable(), allowedAreas() et isAreaAllowed().
Lorsqu'une barre d'outils est redimensionnée de telle sorte qu'elle est trop petite pour afficher tous les éléments qu'elle contient, un bouton d'extension apparaît comme dernier élément de la barre d'outils. En appuyant sur le bouton d'extension, un menu contenant les éléments qui ne tiennent pas dans la barre d'outils s'affiche.
Lorsqu'une QToolBar n'est pas un enfant d'une QMainWindow, elle perd la possibilité de remplir la fenêtre contextuelle d'extension avec des widgets ajoutés à la barre d'outils à l'aide de addWidget(). Veuillez utiliser les actions de widget créées en héritant de QWidgetAction et en implémentant QWidgetAction::createWidget() à la place.
Voir également QToolButton, QMenu, et QAction.
Documentation sur les propriétés
allowedAreas : Qt::ToolBarAreas
les zones où la barre d'outils peut être placée
La valeur par défaut est Qt::AllToolBarAreas.
Cette propriété n'a de sens que si la barre d'outils se trouve dans un site QMainWindow.
Fonctions d'accès :
| Qt::ToolBarAreas | allowedAreas() const |
| void | setAllowedAreas(Qt::ToolBarAreas areas) |
Signal du notificateur :
| void | allowedAreasChanged(Qt::ToolBarAreas allowedAreas) |
Voir aussi movable.
floatable : bool
Cette propriété indique si la barre d'outils peut être déplacée et déposée comme une fenêtre indépendante.
La valeur par défaut est true.
Fonctions d'accès :
| bool | isFloatable() const |
| void | setFloatable(bool floatable) |
[read-only] floating : bool
Cette propriété indique si la barre d'outils est une fenêtre indépendante.
Par défaut, cette propriété vaut true.
Fonctions d'accès :
| bool | isFloating() const |
Voir également QWidget::isWindow().
iconSize : QSize
la taille des icônes de la barre d'outils.
La taille par défaut est déterminée par le style de l'application et est dérivée de la métrique QStyle::PM_ToolBarIconSize pixel. Il s'agit de la taille maximale qu'une icône peut avoir. Les icônes de taille inférieure ne seront pas agrandies.
Fonctions d'accès :
| QSize | iconSize() const |
| void | setIconSize(const QSize &iconSize) |
Signal de notification :
| void | iconSizeChanged(const QSize &iconSize) |
movable : bool
Cette propriété indique si l'utilisateur peut déplacer la barre d'outils à l'intérieur de la zone de la barre d'outils ou entre les zones de la barre d'outils.
Par défaut, la valeur de cette propriété est true.
Cette propriété n'a de sens que si la barre d'outils se trouve dans une zone QMainWindow.
Fonctions d'accès :
| bool | isMovable() const |
| void | setMovable(bool movable) |
Signal de notification :
| void | movableChanged(bool movable) |
Voir aussi allowedAreas.
orientation : Qt::Orientation
orientation de la barre d'outils
La valeur par défaut est Qt::Horizontal.
Cette fonction ne doit pas être utilisée lorsque la barre d'outils est gérée par QMainWindow. Vous pouvez utiliser QMainWindow::addToolBar() ou QMainWindow::insertToolBar() si vous souhaitez déplacer une barre d'outils déjà ajoutée à une fenêtre principale vers une autre Qt::ToolBarArea.
Fonctions d'accès :
| Qt::Orientation | orientation() const |
| void | setOrientation(Qt::Orientation orientation) |
Signal de notification :
| void | orientationChanged(Qt::Orientation orientation) |
toolButtonStyle : Qt::ToolButtonStyle
Cette propriété définit le style des boutons de la barre d'outils
Cette propriété définit le style de tous les boutons d'outils qui sont ajoutés en tant que QActions. Notez que si vous ajoutez un QToolButton avec la méthode addWidget(), il n'obtiendra pas ce style de bouton.
Pour que le style des boutons d'outils suive les paramètres du système, définissez cette propriété sur Qt::ToolButtonFollowStyle. Sous Unix, les paramètres utilisateur de l'environnement de bureau seront utilisés. Sur les autres plates-formes, Qt::ToolButtonFollowStyle signifie icône uniquement.
La valeur par défaut est Qt::ToolButtonIconOnly.
Fonctions d'accès :
| Qt::ToolButtonStyle | toolButtonStyle() const |
| void | setToolButtonStyle(Qt::ToolButtonStyle toolButtonStyle) |
Signal Notificateur :
| void | toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle) |
Fonction membre Documentation
[explicit] QToolBar::QToolBar(QWidget *parent = nullptr)
Construit une QToolBar avec l'adresse parent.
[explicit] QToolBar::QToolBar(const QString &title, QWidget *parent = nullptr)
Construit une QToolBar avec l'adresse parent.
La fenêtre donnée title identifie la barre d'outils et est affichée dans le menu contextuel fourni par QMainWindow.
Voir aussi setWindowTitle().
[virtual noexcept] QToolBar::~QToolBar()
Détruit la barre d'outils.
QAction *QToolBar::actionAt(const QPoint &p) const
Renvoie l'action au point p. Cette fonction renvoie zéro si aucune action n'a été trouvée.
Voir également QWidget::childAt().
QAction *QToolBar::actionAt(int x, int y) const
Renvoie l'action au point x, y. Cette fonction renvoie zéro si aucune action n'a été trouvée.
Il s'agit d'une fonction surchargée.
[override virtual protected] void QToolBar::actionEvent(QActionEvent *event)
Réimplémente : QWidget::actionEvent(QActionEvent *event).
[signal] void QToolBar::actionTriggered(QAction *action)
Ce signal est émis lorsqu'une action de cette barre d'outils est déclenchée. Cela se produit lorsque le bouton de l'action est enfoncé ou lorsque l'action est déclenchée d'une autre manière en dehors de la barre d'outils. Le paramètre contient l'action déclenchée action.
QAction *QToolBar::addSeparator()
Ajoute un séparateur à la fin de la barre d'outils.
Voir aussi insertSeparator().
QAction *QToolBar::addWidget(QWidget *widget)
Ajoute le site widget à la barre d'outils en tant que dernier élément de la barre d'outils.
La barre d'outils est propriétaire de widget.
Si vous ajoutez un QToolButton avec cette méthode, le Qt::ToolButtonStyle de la barre d'outils ne sera pas respecté.
Remarque : vous devez utiliser QAction::setVisible() pour modifier la visibilité du widget. L'utilisation de QWidget::setVisible(), QWidget::show() et QWidget::hide() ne fonctionne pas.
Voir aussi insertWidget().
[signal] void QToolBar::allowedAreasChanged(Qt::ToolBarAreas allowedAreas)
Ce signal est émis lorsque la collection de zones autorisées pour la barre d'outils est modifiée. Les nouvelles zones dans lesquelles la barre d'outils peut être positionnée sont spécifiées par allowedAreas.
Note : Signal de notification pour la propriété allowedAreas.
Voir également allowedAreas.
[override virtual protected] void QToolBar::changeEvent(QEvent *event)
Réimplémente : QWidget::changeEvent(QEvent *event).
void QToolBar::clear()
Supprime toutes les actions de la barre d'outils.
Voir aussi removeAction().
[override virtual protected] bool QToolBar::event(QEvent *event)
Réimplémente : QWidget::event(QEvent *event).
[signal] void QToolBar::iconSizeChanged(const QSize &iconSize)
Ce signal est émis lorsque la taille de l'icône est modifiée. Le paramètre iconSize contient la nouvelle taille de l'icône de la barre d'outils.
Note : Signal de notification pour la propriété iconSize.
Voir également iconSize et QMainWindow::iconSize.
QAction *QToolBar::insertSeparator(QAction *before)
Insère un séparateur dans la barre d'outils devant l'élément de la barre d'outils associé à l'action before.
Voir aussi addSeparator().
QAction *QToolBar::insertWidget(QAction *before, QWidget *widget)
Insère l'adresse widget devant l'élément de la barre d'outils associé à l'action before.
Remarque : vous devez utiliser QAction::setVisible() pour modifier la visibilité du widget. L'utilisation de QWidget::setVisible(), QWidget::show() et QWidget::hide() ne fonctionne pas.
Voir aussi addWidget().
bool QToolBar::isAreaAllowed(Qt::ToolBarArea area) const
Renvoie true si cette barre d'outils est ancrable dans le site area; sinon, renvoie false.
[signal] void QToolBar::movableChanged(bool movable)
Ce signal est émis lorsque la barre d'outils devient mobile ou fixe. Si la barre d'outils peut être déplacée, movable est vrai, sinon il est faux.
Note : Signal de notification pour la propriété movable.
Voir également movable.
[signal] void QToolBar::orientationChanged(Qt::Orientation orientation)
Ce signal est émis lorsque l'orientation de la barre d'outils change. Le paramètre orientation contient la nouvelle orientation de la barre d'outils.
Note : Signal de notification pour la propriété orientation.
Voir aussi orientation.
[override virtual protected] void QToolBar::paintEvent(QPaintEvent *event)
Réimplémente : QWidget::paintEvent(QPaintEvent *event).
QAction *QToolBar::toggleViewAction() const
Renvoie une action vérifiable qui peut être utilisée pour afficher ou masquer cette barre d'outils.
Le texte de l'action correspond au titre de la fenêtre de la barre d'outils.
Voir également QAction::text et QWidget::windowTitle.
[signal] void QToolBar::toolButtonStyleChanged(Qt::ToolButtonStyle toolButtonStyle)
Ce signal est émis lorsque le style du bouton d'outil est modifié. Le paramètre toolButtonStyle contient le nouveau style de bouton d'outil de la barre d'outils.
Note : Signal de notification pour la propriété toolButtonStyle.
Voir également toolButtonStyle et QMainWindow::toolButtonStyle.
[signal] void QToolBar::topLevelChanged(bool topLevel)
Ce signal est émis lorsque la propriété floating est modifiée. Le paramètre topLevel est vrai si la barre d'outils est maintenant flottante, sinon il est faux.
Voir aussi isWindow().
[signal] void QToolBar::visibilityChanged(bool visible)
Ce signal est émis lorsque la barre d'outils devient visible (ou invisible). Cela se produit lorsque le widget est caché ou affiché.
QWidget *QToolBar::widgetForAction(QAction *action) const
Renvoie le widget associé à l'adresse action spécifiée.
Voir aussi addWidget().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
