QMainWindow

La classe QMainWindow fournit une fen�tre principale pour l'application. Plus d'informations...

#include <QMainWindow>

Voir la position dans l'arbre des classes.

H�ritage

H�rite de QWidget.

Description d�taill�e

La classe QMainWindow fournit une fen�tre principale pour l'application.

Le framework de fen�tre principale de Qt

Une fen�tre principale fournit un cadre (framework) pour la construction de l?interface utilisateur d?une application. Qt dispose de QMainWindow et de ses classes associ�es pour la gestion de la fen�tre principale. QMainWindow poss�de sa propre disposition d'�l�ments (layout) auquel on peut ajouter des barres d?outils QToolBar, des widgets docks QDockWidget, une barre de menus QMenuBar et une barre d?�tat QStatusBar. Le layout poss�de une aire centrale qui peut �tre occup�e par n?importe quel type de widget. On peut voir un sch�ma du layout ci-dessous.

� noter : la cr�ation d?une fen�tre principale sans widget central n?est pas prise en charge. On doit avoir un widget central m�me s?il s?agit juste d?un widget servant � occuper l?espace.

Cr�ation des composants de la fen�tre principale

Typiquement, un widget central est un widget Qt standard tel qu?un QTextEdit ou un QGraphicsView. Les widgets personnalis�s peuvent aussi �tre utilis�s pour des applications avanc�es. On peut sp�cifier le widget central avec setCentralWidget().

Les fen�tres principales peuvent avoir une interface de document simple (SDI) ou multiple (MDI). On cr�e des applications MDI dans Qt en utilisant un QMdiArea comme widget central.

Nous allons maintenant examiner chacun des autres widgets pouvant �tre ajout�s � la fen�tre principale. Nous donnerons des exemples sur la fa�on de les cr�er et de les ajouter.

Cr�ation de menus

Qt impl�mente les menus dans la classe QMenu, et QMainWindow les conserve dans une barre de menus QMenuBar. Des QAction sont ajout�es aux menus, qui les affichent en tant qu?�l�ments de menu.

On peut ajouter de nouveaux menus � la barre de menus de la fen�tre principale en appelant menuBar(), qui retourne le QMenuBar pour la fen�tre, puis ajouter un menu avec QMenuBar::addMenu().

QMainWindow est fourni avec une barre de menu par d�faut, mais on peut aussi en sp�cifier une autre avec setMenuBar(). Si on souhaite impl�menter une barre de menu personnalis�e (c?est-�-dire ne pas utiliser le widget QMenuBar), on peut la sp�cifier avec setMenuWidget().

Voici un exemple sur la fa�on de cr�er des menus :

 void MainWindow::createMenus()
 {
     fileMenu = menuBar()->addMenu(tr("&File"));
     fileMenu->addAction(newAct);
     fileMenu->addAction(openAct);
     fileMenu->addAction(saveAct);

La fonction createPopupMenu() cr�e des menus contextuels lorsque la fen�tre principale re�oit des �v�nements de menu contextuel. L?impl�mentation par d�faut g�n�re un menu avec des actions cochables provenant des widgets docks et des barres d?outils. Il est possible de r�impl�menter createPopupMenu() pour obtenir un menu personnalis�.

Cr�ation des barres d?outils

Les barres d?outils sont impl�ment�es dans la classe QToolBar. On peut ajouter une barre d?outils � la fen�tre principale avec addToolBar().

On contr�le la position initiale des barres d?outils en les associant � une Qt::ToolBarArea sp�cifique. On peut diviser une zone en ins�rant un s�parateur de barres d?outils ? similaire � un saut de ligne dans l?�dition de texte ? avec addToolBarBreak() ou insertToolBarBreak(). On peut aussi limiter le placement par l?utilisateur avec QToolBar::setAllowedAreas() et QToolBar::setMovable().

La taille des ic�nes de la barre d?outils peut �tre retrouv�e avec iconSize(). Les tailles sont d�pendantes de la plateforme ; on peut affecter une taille fixe avec setIconSize(). On peut modifier l?apparence de tous les boutons d?outils dans la barre d?outils avec setToolButtonStyle().

Voici un exemple de cr�ation de barre d?outils :

 void MainWindow::createToolBars()
 {
     fileToolBar = addToolBar(tr("File"));
     fileToolBar->addAction(newAct);

Cr�ation de widgets docks

Les widgets docks sont impl�ment�s dans la classe QDockWidget. Un widget dock est une fen�tre qui peut �tre encastr�e (docked) dans une fen�tre principale. On peut ajouter des widgets docks � une fen�tre principale avec addDockWidget().

Il existe quatre zones donn�es par l?�num�ration Qt::DockWidgetArea : gauche, droit, haut, bas. On peut sp�cifier quelle zone de widgets docks doivent occuper les coins o� les zones se chevauchent avec setCorner(). Par d�faut, chaque zone ne peut contenir qu?une seule ligne (verticale ou horizontale) de widgets docks, mais si on l'autorise avec setDockNestingEnabled(), les widgets docks peuvent �tre ajout�s dans les deux directions en partageant l'espace de la zone.

Deux widgets docks peuvent aussi �tre empil�s l?un sur l?autre. Une barre d?onglets QTabBar est alors utilis�e pour choisir lequel des widgets doit �tre affich�.

Voici un exemple sur la fa�on de cr�er et d?ajouter des widgets docks � une fen�tre principale :

     QDockWidget *dockWidget = new QDockWidget(tr("Dock Widget"), this);
     dockWidget->setAllowedAreas(Qt::LeftDockWidgetArea |
                                 Qt::RightDockWidgetArea);
     dockWidget->setWidget(dockWidgetContents);
     addDockWidget(Qt::LeftDockWidgetArea, dockWidget);

Barre d?�tat

On peut d�finir une barre d?�tat avec setStatusBar(), mais, si elle n'a pas �t� d�finie, elle le sera au premier appel de statusBar() (qui retourne la barre d?�tat de la fen�tre principale). Voir QStatusBar pour plus d?informations sur la fa�on de l?utiliser.

Le stockage de l'�tat

QMainWindow peut stocker l'�tat de sa disposition avec saveState() ; il peut �tre retrouv� plus tard avec restoreState(). Les informations stock�es sont la position et la taille (par rapport � la taille de la fen�tre principale) des barres d'outils et des widgets docks.

Voir aussi QMenuBar, QToolBar, QStatusBar, QDockWidget, Exemple d'application, Exemple de widgets docks, Exemple MDI, Exemple SDI et Exemple de menus.

Type

enum QMainWindow::DockOptionflags QMainWindow::DockOptions

Cette �num�ration contient des drapeaux qui sp�cifient le comportement des widgets docks pour la QMainWindow.

Ces options contr�lent uniquement la fa�on dont les widgets docks peuvent �tre d�pos�s dans une QMainWindow. Elles ne r�organisent pas les widgets docks pour les rendre conformes aux options sp�cifi�es. Pour cette raison, elles devraient �tre d�finies avant que les widgets docks ne soient ajout�s � la fen�tre principale. Les seules exceptions � cela sont les options AnimatedDocks et VerticalTabs qui peuvent �tre d�finies � tout moment.

Cette �num�ration a �t� introduite ou modifi�e dans Qt 4.3.

Le type DockOptions est un typedef pour QFlags<DockOption>. Il stocke une combinaison de OU logiques de valeurs de DockOption.

Propri�t�s

animated : bool

Cette propri�t� d�termine si la manipulation des widgets docks et des barres d?outils est anim�e.

Lorsqu?un widget dock ou une barre d?outils sont gliss�s sur la fen�tre principale, cette derni�re ajuste son contenu pour indiquer l?endroit o� le widget dock ou la barre d?outils seront stock�s s'ils sont d�pos�s. Activer cette propri�t� implique que le d�placement du contenu de QMainWindow se fait suivant une animation fluide. D�sactiver cette propri�t� implique que le contenu saute instantan�ment � sa nouvelle position.

Par d�faut, cette propri�t� est activ�e. Elle peut �tre d�sactiv�e si la fen�tre principale contient des widgets lents � redimensionner ou � repeindre.

Activer cette propri�t� est �quivalent � activer l?option AnimatedDocks en utilisant setDockOptions().

Cette propri�t� a �t� introduite dans Qt 4.2.

Fonction d'acc�s

bool isAnimated () const

void setAnimated ( bool enabled )

dockNestingEnabled : bool

Cette propri�t� d�termine si les widgets docks peuvent �tre empil�s.

Si cette propri�t� est � false, les zones de dock ne peuvent contenir qu?une seule ligne (horizontale ou verticale) de widgets docks. Si elle est � true, la zone occup�e par un widget dock peut �tre divis�e dans les deux directions pour contenir plusieurs widgets docks juxtapos�s.

La juxtaposition de widgets docks est n�cessaire uniquement pour les applications qui contiennent plusieurs widgets docks. Cela fournit � l?utilisateur une plus grande libert� dans l?organisation de la fen�tre principale. Toutefois, la juxtaposition conduit � un comportement plus complexe (et moins intuitif) lorsqu?un widget dock est gliss� sur la fen�tre principale, �tant donn� qu?il existe plus de fa�ons de placer un widget dock d�pos� dans la zone de dock.

D�finir cette propri�t� est �quivalent � activer l?option AllowNestedDocks en utilisant setDockOptions().

Cette propri�t� a �t� introduite dans Qt 4.2.

Fonction d'acc�s

bool isDockNestingEnabled () const

void setDockNestingEnabled ( bool enabled )

dockOptions : DockOptions

Cette propri�t� enregistre le comportement de docking de QMainWindow.

La valeur par d�faut est AnimatedDocks | AllowTabbedDocks.

Cette propri�t� a �t� introduite dans Qt 4.3.

Fonction d'acc�s

DockOptions dockOptions () const

void setDockOptions ( DockOptions options )

documentMode : bool

Cette propri�t� d�termine si la barre d'onglets des widgets docks est en mode document.

La valeur par d�faut est false.

Cette propri�t� a �t� introduite dans Qt 4.5.

Fonction d'acc�s

bool documentMode () const

void setDocumentMode ( bool enabled )

Voir aussi QTabBar::documentMode.

iconSize : QSize

Cette propri�t� enregistre la taille des ic�nes de la barre d'outils de cette fen�tre principale.

La valeur par d�faut est la taille d'ic�ne de barre d'outils par d�faut dans ce style d'IHM. � noter que les ic�nes utilis�es doivent �tre au moins de cette taille, �tant donn� que la taille des ic�nes ne peut qu'�tre r�duite.

Fonction d'acc�s

QSize iconSize () const

void setIconSize ( const QSize & iconSize )

tabShape : QTabWidget::TabShape

Cette propri�t� enregistre la forme d'onglet utilis�e par les widgets docks avec onglets.

La valeur par d�faut est QTabWidget::Rounded.

Cette propri�t� a �t� introduite dans Qt 4.5.

Fonction d'acc�s

QTabWidget::TabShape tabShape () const

void setTabShape ( QTabWidget::TabShape tabShape )

Voir aussi setTabPosition().

toolButtonStyle : Qt::ToolButtonStyle

Cette propri�t� enregistre le style des boutons de barre d'outils dans cette fen�tre principale.

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

Fonction d'acc�s

Qt::ToolButtonStyle toolButtonStyle () const

void setToolButtonStyle ( Qt::ToolButtonStyle toolButtonStyle )

unifiedTitleAndToolBarOnMac : bool

Cette propri�t� d�termine si la fen�tre utilise l?apparence de barre de titre et de barre d?outils unifi�e sous Mac OS X.

Cette propri�t� est � false par d�faut, et n?a d?effet que sur Mac OS X 10.4 ou sup�rieur.

Si elle vaut true, la zone de la barre d?outils principale est remplac�e par une HIToolbar Carbon ou une NSToolbar Cocoa (selon que Qt a �t� construit avec Carbon ou Cocoa). Toutes les barres d?outils dans la zone de la barre d?outils principale, et toutes les barres d?outils ajout�es apr�s, y sont d�plac�es. Cela implique un certain nombre de choses :

• les QToolBar dans cette zone de barre d?outils ne sont pas d�pla�ables, et on ne peut pas y glisser d?autres barres d?outils ;
• les s�parateurs de barres d?outils ne sont pas respect�s ni conserv�s ;
• aucun widget personnalis� dans la barre d?outils ne sera affich� si la barre d?outils devient trop petite (seules les actions seront affich�es) ;
• avant Qt 4.5, si on appelle showFullScreen() sur la fen�tre principale, le QToolbar va dispara�tre �tant donn� qu?il est consid�r� comme faisant partie de la barre de titre. Qt 4.5 et sup�rieur contourne cela en enlevant puis en remettant les barres d?outils dans la barre d?outils habituelle ? et vice-versa ? lors de l?�change.

Fixer cette propri�t� � false supprime ces restrictions.

L?attribut Qt::WA_MacBrushedMetal est prioritaire sur cette propri�t�.

Cette propri�t� a �t� introduite dans Qt 4.3.

Fonction d'acc�s

bool unifiedTitleAndToolBarOnMac () const

void setUnifiedTitleAndToolBarOnMac ( bool set )

Fonctions membres

QMainWindow::QMainWindow ( QWidget * parent = 0, Qt::WindowFlags flags = 0 )

Construit un QMainWindow avec le parent donn� et les drapeaux flags sp�cifi�s.

QMainWindow d�finit le drapeau Qt::Window lui-m�me et sera donc toujours cr�� en tant que widget de premier niveau.

QMainWindow::~QMainWindow ()

D�truit la fen�tre principale.

void QMainWindow::addDockWidget ( Qt::DockWidgetArea area, QDockWidget * dockwidget )

Ajoute le widget dock dockwidget donn� � la zone area sp�cifi�e.

void QMainWindow::addDockWidget ( Qt::DockWidgetArea area, QDockWidget * dockwidget, Qt::Orientation orientation )

Ajoute le widget dock dockwidget donn� � la zone area sp�cifi�e, dans la direction sp�cifi�e par orientation.

void QMainWindow::addToolBar ( Qt::ToolBarArea area, QToolBar * toolbar )

Ajoute le widget dock dockwidget donn� � la zone area sp�cifi�e. La barre d'outils toolbar est plac�e � la fin du bloc (la ligne) de barre d'outils courant. Si la fen�tre principale g�re d�j� toolbar, alors elle sera simplement d�plac�e dans la zone area.

Voir aussi insertToolBar(), addToolBarBreak() et insertToolBarBreak().

void QMainWindow::addToolBar ( QToolBar * toolbar )

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

�quivalent � l'appel de addToolBar(Qt::TopToolBarArea, toolbar).

QToolBar * QMainWindow::addToolBar ( const QString & title )

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

Cr�e un objet QToolBar, fixe son titre de fen�tre � title et l'ins�re dans la zone de barre d'outils principale.

Voir aussi setWindowTitle().

void QMainWindow::addToolBarBreak ( Qt::ToolBarArea area = Qt::TopToolBarArea )

Ajoute un s�parateur de barres d'outils � la zone area sp�cifi�e apr�s tous les objets qui y sont pr�sents.

QWidget * QMainWindow::centralWidget () const

Retourne le widget central de la fen�tre principale. Cette fonction retourne z�ro si le widget central n'a pas �t� d�fini.

Voir aussi setCentralWidget().

void QMainWindow::contextMenuEvent ( QContextMenuEvent * event ) [virtual protected]

R�impl�mentation de QWidget::contextMenuEvent().

Qt::DockWidgetArea QMainWindow::corner ( Qt::Corner corner ) const

Retourne la zone de widgets docks occupant le coin corner sp�cifi�.

Voir aussi setCorner().

QMenu * QMainWindow::createPopupMenu () [virtual]

Retourne un menu contextuel contenant des entr�es cochables pour les barres d?outils et les widgets docks pr�sents dans la fen�tre principale. Si aucune barre d?outils ni widget dock n'est pr�sent, cette fonction retourne un pointeur nul.

Par d�faut, cette fonction est appel�e par la fen�tre principale lorsque l?utilisateur active un menu contextuel, typiquement en faisant un clic droit sur une barre d?outils ou un widget dock.

Si on souhaite cr�er un menu contextuel personnalis�, on r�impl�mente cette fonction pour qu?elle retourne un menu contextuel sp�cialement cr��. L?appelant du menu contextuel devient propri�taire du menu contextuel.

Voir aussi addDockWidget(), addToolBar() et menuBar().

Qt::DockWidgetArea QMainWindow::dockWidgetArea ( QDockWidget * dockwidget ) const

Retourne le Qt::DockWidgetArea pour le widget dock dockwidget. Si dockwidget n'a pas �t� ajout� � la fen�tre principale, cette fonction retourne Qt::NoDockWidgetArea.

Voir aussi addDockWidget(), splitDockWidget() et Qt::DockWidgetArea.

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

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

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

Ce signal est �mis lorsque la taille des ic�nes utilis�es dans la fen�tre est modifi�e. La nouvelle taille d'ic�ne est fournie par iconSize.

On peut connecter ce signal aux autres composants pour aider l'application � conserver une apparence coh�rente.

Voir aussi setIconSize().

void QMainWindow::insertToolBar ( QToolBar * before, QToolBar * toolbar )

Ins�re la barre d'outils toolbar dans la zone occup�e par la barre d'outils before, afin qu'elle apparaisse avant before. Par exemple, dans une op�ration avec une disposition habituelle de gauche � droite et dans une zone de barres d'outils horizontale, cela signifie que toolbar apparaitra � la gauche de la barre d'outils sp�cifi�e par before

Voir aussi insertToolBarBreak(), addToolBar() et addToolBarBreak().

void QMainWindow::insertToolBarBreak ( QToolBar * before )

Ins�re un s�parateur de barres d'outils avant la barre d'outils sp�cifi�e par before.

QMenuBar * QMainWindow::menuBar () const

Retourne la barre de menus pour la fen�tre principale. Cette fonction cr�e et retourne une barre de menus vide si la barre de menus n?existe pas.

Si l'on souhaite que toutes les fen�tres d?une application Mac partagent une seule barre de menus, il ne faut pas utiliser cette fonction pour la cr�er, car la barre de menus cr��e ici aura pour parent cette QMainWindow. � la place, on doit cr�er une barre de menus sans parent, que l?on peut alors partager avec toutes les fen�tres Mac. On peut cr�er une barre de menus sans parent de cette fa�on :

 QMenuBar *menuBar = new QMenuBar(0);

Voir aussi setMenuBar().

QWidget * QMainWindow::menuWidget () const

Retourne la barre de menus de cette fen�tre principale. Cette fonction retourne z�ro si une barre de menus n'a pas encore �t� construite.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi setMenuWidget().

void QMainWindow::removeDockWidget ( QDockWidget * dockwidget )

Retire le widget dock dockwidget du layout de la fen�tre principale et le cache. � noter que le dockwidget n'est pas supprim�.

void QMainWindow::removeToolBar ( QToolBar * toolbar )

Retire la barre d'outils toolbardu layout de la fen�tre principale et la cache. � noter que la toolbar n?est pas supprim�e.

void QMainWindow::removeToolBarBreak ( QToolBar * before )

Retire le s�parateur de barres d'outils pr�c�demment ins�r� avant la barre d'outils sp�cifi�e par before.

bool QMainWindow::restoreDockWidget ( QDockWidget * dockwidget )

Restaure l'�tat du widget dock dockwidget s'il a �t� cr�� apr�s l'appel � restoreState(). Retourne true si l'�tat a �t� restaur� ; sinon retourne false.

Voir aussi restoreState() et saveState().

bool QMainWindow::restoreState ( const QByteArray & state, int version = 0 )

Restaure l'�tat state des barres d'outils et des widgets docks de cette fen�tre principale. Le num�ro de version est compar� avec celui stock� dans state. S'ils ne correspondent pas, l'�tat de la fen�tre principale est laiss� inchang� et cette fonction retourne false ; sinon, l'�tat est restaur� et cette fonction retourne true.

Pour restaurer la g�om�trie sauvegard�e en utilisant QSettings, on peut utiliser un code similaire � :

 void MainWindow::readSettings()
 {
     QSettings settings("MyCompany", "MyApp");
     restoreGeometry(settings.value("myWidget/geometry").toByteArray());
     restoreState(settings.value("myWidget/windowState").toByteArray());
 }

Voir aussi saveState(), QWidget::saveGeometry(), QWidget::restoreGeometry() et restoreDockWidget().

QByteArray QMainWindow::saveState ( int version = 0 ) const

Sauvegarde l'�tat courant des barres d?outils et des widgets docks de cette fen�tre principale. Le num�ro de version est enregistr� avec les autres donn�es.

La propri�t� objectName est utilis�e pour identifier chaque QToolBar et QDockWidget. On doit s'assurer que chaque propri�t� est unique pour chaque QToolBar et QDockWidget que l'on ajoute � QMainWindow.

Pour restaurer l'�tat sauvegard�, on passe la valeur de retour et le num�ro de version � restoreState().

Pour sauvegarder la g�om�trie lorsque la fen�tre est ferm�e, on peut impl�menter un �v�nement de fermeture comme ceci :

 void MyMainWindow::closeEvent(QCloseEvent *event)
 {
     QSettings settings("MyCompany", "MyApp");
     settings.setValeur("geometry", saveGeometry());
     settings.setValeur("windowState", saveState());
     QMainWindow::closeEvent(event);
 }

Voir aussi restoreState(), QWidget::saveGeometry() et QWidget::restoreGeometry().

void QMainWindow::setCentralWidget ( QWidget * widget )

D�finit le widget donn� en tant que widget central de la fen�tre principale.

� noter : QMainWindow devient propri�taire du pointeur widget et le supprimera en temps voulu.

Voir aussi centralWidget().

void QMainWindow::setCorner ( Qt::Corner corner, Qt::DockWidgetArea area )

Sp�cifie que le coin corner sp�cifi� sera occup� par la zone de widgets docks area.

Voir aussi corner().

void QMainWindow::setMenuBar ( QMenuBar * menuBar )

D�finit menuBar comme barre de menus de la fen�tre principale.

� noter : QMainWindow devient propri�taire du pointeur menuBar et le supprimera en temps voulu.

Voir aussi menuBar().

void QMainWindow::setMenuWidget ( QWidget * menuBar )

D�finit menuBar comme barre de menus de la fen�tre principale.

QMainWindow devient propri�taire du pointeur menuBar et le supprimera en temps voulu.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi menuWidget().

void QMainWindow::setStatusBar ( QStatusBar * statusbar )

D�finit statusBar comme barre d'�tat de la fen�tre principale.

D�finir la barre d'�tat � 0 la supprimera de la fen�tre principale. � noter que QMainWindow devient propri�taire du pointeur statusBar et le supprimera en temps voulu.

Voir aussi statusBar().

void QMainWindow::setTabPosition ( Qt::DockWidgetAreas areas, QTabWidget::TabPosition tabPosition )

Fixe la position des onglets des zones de widgets docks areas donn�es � la position tabPosition sp�cifi�e. Par d�faut, toutes les zones de docks affichent les onglets au bas de la zone.

� noter : l'option de dock VerticalTabs �crase les positions des onglets d�finies par cette m�thode.

Cette fonction a �t� introduite dans Qt 4.5.

Voir aussi tabPosition() et setTabShape().

void QMainWindow::splitDockWidget ( QDockWidget * first, QDockWidget * second, Qt::Orientation orientation )

Divise l?espace couvert par le widget dock first en deux parties, d�place le widget dock first dans la premi�re partie et d�place le widget dock second dans la deuxi�me partie.

L?orientation sp�cifie la fa�on dont l?espace est divis� : une division Qt::Horizontal place le deuxi�me widget dock � la droite du premier ; une division Qt:: Vertical place le deuxi�me widget dock sous le premier.

� noter : si first est actuellement dans une zone de docks avec onglets, second sera ajout� dans un nouvel onglet, et non en tant que voisin de first. Ceci est d� au fait qu?un onglet ne peut contenir qu?un seul widget dock.

� noter : la direction du layout Qt::LayoutDirection influence l?ordre des widgets docks dans les deux parties de la zone divis�e. Lorsque la direction du layout est de droite � gauche, le placement des widgets docks sera invers�.

Voir aussi tabifyDockWidget(), addDockWidget() et removeDockWidget().

QStatusBar * QMainWindow::statusBar () const

Retourne la barre d'�tat de la fen�tre principale. Cette fonction cr�e et retourne une barre d'�tat vide si la barre d'�tat n'existe pas.

Voir aussi setStatusBar().

QTabWidget::TabPosition QMainWindow::tabPosition ( Qt::DockWidgetArea area ) const

Retourne la position des onglets pour la zone area.

� noter : l'option de dock VerticalTabs �crase les positions des onglets d�finies par cette m�thode.

Cette fonction a �t� introduite dans Qt 4.5.

Voir aussi setTabPosition() et tabShape().

QList<QDockWidget *> QMainWindow::tabifiedDockWidgets ( QDockWidget * dockwidget ) const

Retourne les widgets docks se trouvant dans le m�me groupe d'onglets que le widget dock dockwidget.

Cette fonction a �t� introduite dans Qt 4.5.

Voir aussi tabifyDockWidget().

void QMainWindow::tabifyDockWidget ( QDockWidget * first, QDockWidget * second )

D�place le widget dock second au-dessus du widget dock first, en cr�ant une zone de dock avec onglets dans la fen�tre principale.

Voir aussi tabifiedDockWidgets().

Qt::ToolBarArea QMainWindow::toolBarArea ( QToolBar * toolbar ) const

Retourne la zone Qt::ToolBarArea de la barre d'outils toolbar. Si toolbar n'a pas �t� ajout�e � la fen�tre principale, cette fonction retourne Qt::NoToolBarArea.

Voir aussi addToolBar(), addToolBarBreak() et Qt::ToolBarArea.

bool QMainWindow::toolBarBreak ( QToolBar * toolbar ) const

Retourne true si un s�parateur de barres d'outils est pr�sent avant la barre d'outils toolbar.

Voir aussi addToolBarBreak() et insertToolBarBreak().

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

Ce signal est �mis lorsque le style utilis� pour la fen�tre est modifi�. Le nouveau style est pass� dans toolButtonStyle.

On peut connecter ce signal aux autres composants pour aider � l'application � conserver une apparence coh�rente.

Voir aussi setToolButtonStyle().

Remerciements

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