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 !