QToolBar

La classe de barres d'outils QToolBar fournit un panneau déplaçable qui contient un ensemble de contrôles. Plus d'informations...

#include <QToolBar>

Voir la position dans l'arbre des classes.

Héritage

Hérite de QWidget.

Description détaillée

La classe de barres d'outils QToolBar fournit un panneau déplaçable qui contient un ensemble de contrôles.

Les boutons de barre d'outils sont ajoutés via des actions, en utilisant les fonctions addAction() ou insertAction(). Les groupes de boutons peuvent être séparés en utilisant addSeparator() ou insertSeparator(). S'il n'est pas approprié d'utiliser un bouton, on peut utiliser à la place un widget avec addWidget() ou insertWidget() ; QSpinBox, QDoubleSpinBox et QComboBox sont quelques exemples de widgets adaptés. Lorsqu'un bouton de barre d'outils est pressé, il émet le signal actionTriggered().

Une barre d'outils peut être ancrée dans une zone particulière (par exemple, en haut de la fenêtre) ou être déplaçable (isMovable()) entre les différentes zones de barres d'outils ; voir allowedAreas() et isAreaAllowed().

Lorsqu'une barre d'outils est redimensionnée de telle sorte qu'elle soit trop petite pour montrer tous les éléments qu'elle contient, un bouton d'extension apparaît à la place du dernier élément de la barre. L'appui sur ce bouton d'extension fait apparaître un menu popup contenant tous les éléments qui ne rentrent pas actuellement dans la barre d'outils.

Lorsqu'une barre d'outils n'a pas un QMainWindow pour parent, elle perd sa capacité à peupler son extension popup avec des widgets ajoutés via la fonction addWidget(). On utilisera donc plutôt des widgets action dérivés de QWidgetAction et implémentant QWidgetAction::createWidget().

Voir aussi QToolButton, QMenu, QAction et Exemple d'application.

Propriétés

allowedAreas : Qt::ToolBarAreas

Cette propriété contient les zones dans lesquelles 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 est dans une QMainWindow.

Fonction d'accès

Qt::ToolBarAreas allowedAreas () const

void setAllowedAreas ( Qt::ToolBarAreas areas )

Signal de notification :

void allowedAreasChanged ( Qt::ToolBarAreas allowedAreas )

Voir aussi movable.

floatable : bool

Cette propriété indique si la barre d'outils peut être glissée et déposée en tant que fenêtre indépendante.

La valeur par défaut est true.

Fonction d'accès

bool isFloatable () const

void setFloatable ( bool floatable )

floating : const bool

Cette propriété indique si la barre d'outils est une fenêtre indépendante.

La valeur par défaut est true.

Fonction d'accès

bool isFloating () const

Voir aussi QWidget::isWindow().

iconSize : QSize

Cette propriété contient la taille des icônes dans la barre d'outils.

La valeur par défaut est déterminée par le style de l'application et est dérivée des métriques de pixels de QStyle::PM_ToolBarIconSize. Cette valeur est la taille maximale qu'une icône peut avoir. Les icônes de taille inférieure ne seront pas agrandies.

Fonction 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 barres d'outils ou entre les différentes zones de barres d'outils.

La valeur par défaut est true.

Cette propriété n'a de sens que si la barre d'outils est dans une QMainWindow.

Fonction d'accès

bool isMovable () const

void setMovable ( bool movable )

Signal de notification :

void movableChanged ( bool movable )

Voir aussi allowedAreas.

orientation : Qt::Orientation

Cette propriété contient l'orientation de la barre d'outils.

La valeur par défaut est Qt::Horizontal.

Cette fonction ne devrait pas être utilisée lorsque la barre d'outils est gérée par une QMainWindow. Si on souhaite déplacer une barre d'outils (déjà ajoutée à une QMainWindow) vers une autre Qt::ToolBarArea, on peut utiliser QMainWindow::addToolBar() ou QMainWindow::insertToolBar().

Fonction 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é contient le style des boutons de barre d'outils.

Cette propriété définit le style de tous les boutons qui sont ajoutés en tant que QAction. À noter qu'un QToolButton ajouté avec la méthode addWidget() n'aura pas ce style.

La valeur par défaut est Qt::ToolButtonIconOnly.

Fonction d'accès

Qt::ToolButtonStyle toolButtonStyle () const

void setToolButtonStyle ( Qt::ToolButtonStyle toolButtonStyle )

Signal de notification :

void toolButtonStyleChanged ( Qt::ToolButtonStyle toolButtonStyle )

Fonctions membres

QToolBar::QToolBar ( const QString & title, QWidget * parent = 0 )

Construit une QToolBar avec le parent donné.

Le titre title de la fenêtre identifie la barre d'outils et est affiché dans le menu contextuel fourni par QMainWindow.

Voir aussi setWindowTitle().

QToolBar::QToolBar ( QWidget * parent = 0 )

Construit une QToolBar avec le parent donné.

QToolBar::~QToolBar ()

Détruit la barre d'outils.

QAction * QToolBar::actionAt ( const QPoint & p ) const

Retourne l'action située au point p. Retourne zéro si aucune action n'est trouvée.

Voir aussi QWidget::childAt().

QAction * QToolBar::actionAt ( int x, int y ) const

Il s'agit d'une fonction surchargée.

Retourne l'action située au point x, y. Retourne zéro si aucune action n'est trouvée.

void QToolBar::actionEvent ( QActionEvent * event ) [virtual protected]

Réimplémentation de QWidget::actionEvent().

void QToolBar::actionTriggered ( QAction * action ) [signal]

Ce signal est émis lorsqu'une action de la barre d'outils est déclenchée. Cela arrive lorsque le bouton de la barre d'outils est pressé 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.

void QToolBar::addAction ( QAction * action )

Il s'agit d'une fonction surchargée.

Ajoute l'action à la fin de la liste des actions de la barre d'outils.

Voir aussi QMenu::addAction() et QWidget::addAction().

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

Il s'agit d'une fonction surchargée.

Crée une nouvelle action avec le texte text donné. Cette action est ajoutée à la fin de la barre d'outils.

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

Il s'agit d'une fonction surchargée.

Crée une nouvelle action avec l'icône icon et le texte text donnés. Cette action est ajoutée à la fin de la barre d'outils.

QAction * QToolBar::addAction ( const QString & text, const QObject * receiver, const char * member )

Il s'agit d'une fonction surchargée.

Crée une nouvelle action avec le texte text donné. Cette action est ajoutée à la fin de la barre d'outils. Le signal triggered() de l'action est connecté au membre member du récepteur receiver.

QAction * QToolBar::addAction ( const QIcon & icon, const QString & text, const QObject * receiver, const char * member )

Il s'agit d'une fonction surchargée.

Crée une nouvelle action avec l'icône icon et le texte text donnés. Cette action est ajoutée à la fin de la barre d'outils. Le signal triggered() de l'action est connecté au membre member du récepteur receiver.

QAction * QToolBar::addSeparator ()

Ajoute un séparateur à la fin de la barre d'outils.

Voir aussi insertSeparator().

QAction * QToolBar::addWidget ( QWidget * widget )

Ajoute le widget donné à la barre d'outils en tant que dernier élément.

La barre d'outils devient propriétaire du widget.

Un QToolButton ajouté avec cette méthode ne respectera pas le style de la barre d'outils Qt::ToolButtonStyle.

À noter : pour modifier la visibilité du widget, il faut utiliser QAction::setVisible(). Les méthodes QWidget::setVisible(), QWidget::show() et QWidget::hide() ne fonctionneront pas.

Voir aussi insertWidget().

void QToolBar::allowedAreasChanged ( Qt::ToolBarAreas allowedAreas ) [signal]

Ce signal est émis lorsque la liste des zones autorisées pour la barre d'outils est modifiée. Les nouvelles zones sur lesquelles la barre d'outils peut être positionnée sont spécifiées par allowedAreas.

Voir aussi allowedAreas.

void QToolBar::changeEvent ( QEvent * event ) [virtual protected]

Réimplémentation de QWidget::changeEvent().

void QToolBar::childEvent ( QChildEvent * event ) [virtual protected]

Réimplémentation de QObject::childEvent().

void QToolBar::clear ()

Enlève toutes les actions de la barre d'outils.

Voir aussi removeAction().

bool QToolBar::event ( QEvent * event ) [virtual protected]

Réimplémentation de QObject::event().

void QToolBar::iconSizeChanged ( const QSize & iconSize ) [signal]

Ce signal est émis lorsque la taille d'icône est modifiée. Le paramètre iconSize contient la nouvelle taille d'icône de la barre d'outils.

Voir aussi iconSize et QMainWindow::iconSize.

QAction * QToolBar::insertSeparator ( QAction * before )

Insère un séparateur dans la barre d'outils avant l'élément associé à l'action before.

Voir aussi addSeparator().

QAction * QToolBar::insertWidget ( QAction * before, QWidget * widget )

Insère le widget donné dans la barre d'outils avant l'élément associé à l'action before.

À noter : pour modifier la visibilité du widget, il faut utiliser QAction::setVisible(). Les méthodes QWidget::setVisible(), QWidget::show() et QWidget::hide() ne fonctionneront pas.

Voir aussi addWidget().

bool QToolBar::isAreaAllowed ( Qt::ToolBarArea area ) const

Retourne true si la barre d'outils peut être positionnée dans la zone area donnée ; sinon retourne false.

void QToolBar::movableChanged ( bool movable ) [signal]

Ce signal est émis lorsque la barre d'outils devient déplaçable ou ancrée. Si la barre d'outils devient déplaçable, movable est égal à true ; sinon il est égal à false.

Voir aussi movable.

void QToolBar::orientationChanged ( Qt::Orientation orientation ) [signal]

Ce signal est émis lorsque l'orientation de la barre d'outils est modifiée. La nouvelle orientation est spécifiée par l'orientation donnée.

Voir aussi orientation.

void QToolBar::paintEvent ( QPaintEvent * event ) [virtual protected]

Réimplémentation de QWidget::paintEvent().

void QToolBar::resizeEvent ( QResizeEvent * event ) [virtual protected]

Réimplémentation de QWidget::resizeEvent().

QAction * QToolBar::toggleViewAction () const

Retourne une action cochable pouvant être utilisée pour afficher ou cacher cette barre d'outils.

Le texte de l'action prend la valeur du titre de la barre d'outils.

Voir aussi QAction::text et QWidget::windowTitle.

void QToolBar::toolButtonStyleChanged ( Qt::ToolButtonStyle toolButtonStyle ) [signal]

Ce signal est émis lorsque le style de boutons de la barre d'outils est modifié. Le paramètre toolButtonStyle contient le nouveau style de boutons.

Voir aussi toolButtonStyle et QMainWindow::toolButtonStyle.

void QToolBar::topLevelChanged ( bool topLevel ) [signal]

Ce signal est émis lorsque la propriété floating est modifiée. Le paramètre topLevel est égal à true si la barre d'outils devient flottante ; sinon il est égal à false.

Cette fonction a été introduite dans Qt 4.6.

Voir aussi isWindow().

void QToolBar::visibilityChanged ( bool visible ) [signal]

Ce signal est émis lorsque la barre d'outils devient visible (ou invisible). Ceci se produit lorsque le widget est caché ou affiché.

Cette fonction a été introduite dans Qt 4.7.

QWidget * QToolBar::widgetForAction ( QAction * action ) const

Retourne le widget associé à l'action spécifiée.

Cette fonction a été introduite dans Qt 4.2.

Voir aussi addWidget().

Remerciements

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