QMainWindow Class

Documentation des fonctions membres

[explicit] QMainWindow::QMainWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Crée une fenêtre QMainWindow avec l'parent on indiquée et le widget spécifié flags.

QMainWindow active lui-même l'indicateur « Qt::Window » et sera donc toujours créé en tant que widget de niveau supérieur.

[virtual noexcept] QMainWindow::~QMainWindow()

Ferme la fenêtre principale.

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

Ajoute l'dockwidget ion indiquée à l'area spécifiée dans la fenêtre principale.

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

Ajoute dockwidget à l'area indiquée, dans la direction spécifiée par orientation.

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

Ajoute l'toolbar à l'area spécifiée dans cette fenêtre principale. L'toolbar est placée à la fin du bloc (c'est-à-dire de la ligne) actuel de la barre d'outils. Si la fenêtre principale gère déjà toolbar, la barre d'outils sera simplement déplacée vers area.

Voir également insertToolBar(), addToolBarBreak() et insertToolBarBreak().

void QMainWindow::addToolBar(QToolBar *toolbar)

Cela revient à appeler addToolBar(Qt::TopToolBarArea, toolbar)

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

Crée un objet ` QToolBar `, en définissant le titre de sa fenêtre sur « title », puis l'insère dans la zone de la barre d'outils supérieure.

Voir également setWindowTitle().

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

Ajoute une coupure de barre d'outils à l'area on indiquée, après tous les autres objets présents.

QWidget *QMainWindow::centralWidget() const

Renvoie le widget central de la fenêtre principale. Cette fonction renvoie « nullptr » si le widget central n’a pas été défini.

Voir également setCentralWidget().

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

Réimplémente : QWidget::contextMenuEvent(QContextMenuEvent *event).

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

Renvoie la zone du widget du dock qui occupe l'corner spécifiée.

Voir aussi setCorner().

[virtual] QMenu *QMainWindow::createPopupMenu()

Renvoie un menu contextuel contenant des éléments cochables correspondant aux barres d'outils et aux widgets ancrés présents dans la fenêtre principale. S'il n'y a ni barres d'outils ni widgets ancrés, cette fonction renvoie « nullptr ».

Par défaut, cette fonction est appelée par la fenêtre principale lorsque l’utilisateur active un menu contextuel, généralement en cliquant avec le bouton droit de la souris sur une barre d’outils ou un widget d’ancrage.

Si vous souhaitez créer un menu contextuel personnalisé, réimplémentez cette fonction et renvoyez un menu contextuel nouvellement créé. La propriété du menu contextuel est transférée à l'appelant.

Voir également addDockWidget(), addToolBar() et menuBar().

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

Renvoie l'Qt::DockWidgetArea pour dockwidget. Si dockwidget n'a pas été ajouté à la fenêtre principale, cette fonction renvoie Qt::NoDockWidgetArea.

Voir également addDockWidget(), splitDockWidget() et Qt::DockWidgetArea.

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

Réimplémente : QWidget::event(QEvent *event).

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

Ce signal est émis lorsque la taille des icônes utilisées dans la fenêtre est modifiée. La nouvelle taille des icônes est transmise dans ` iconSize`.

Vous pouvez connecter ce signal à d'autres composants afin de garantir une apparence cohérente à votre application.

Voir également setIconSize().

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

Insère l'élément toolbar dans la zone occupée par la barre d'outils before afin qu'il apparaisse avant celle-ci. Par exemple, dans le cadre d'une mise en page normale de gauche à droite, cela signifie que l'élément toolbar apparaîtra à gauche de la barre d'outils spécifiée par before dans une zone de barre d'outils horizontale.

Voir également insertToolBarBreak(), addToolBar() et addToolBarBreak().

void QMainWindow::insertToolBarBreak(QToolBar *before)

Insère une coupure de barre d'outils avant la barre d'outils spécifiée par ` before`.

QMenuBar *QMainWindow::menuBar() const

Renvoie la barre de menus de la fenêtre principale. Cette fonction crée et renvoie une barre de menus vide si celle-ci n'existe pas.

Si vous souhaitez que toutes les fenêtres d’une application Mac partagent une même barre de menus, n’utilisez pas cette fonction pour la créer, car la barre de menus ainsi créée aura pour parent l’ QMainWindow. Vous devez plutôt créer une barre de menus sans parent, que vous pourrez ensuite partager entre toutes les fenêtres Mac. Créez une barre de menus sans parent de la manière suivante :

QMenuBar *menuBar = new QMenuBar(nullptr);

Voir également ` setMenuBar()` ().

QWidget *QMainWindow::menuWidget() const

Renvoie la barre de menu de la fenêtre principale. Cette fonction renvoie `null` si aucune barre de menu n'a encore été créée.

Voir aussi setMenuWidget().

void QMainWindow::removeDockWidget(QDockWidget *dockwidget)

Supprime l'dockwidget e de la disposition de la fenêtre principale et le masque. Notez que l'dockwidget e n' est pas supprimé.

void QMainWindow::removeToolBar(QToolBar *toolbar)

Supprime l'toolbar e de la disposition de la fenêtre principale et la masque. Notez que l'toolbar e n' est pas supprimée.

void QMainWindow::removeToolBarBreak(QToolBar *before)

Supprime une coupure de barre d'outils précédemment insérée avant la barre d'outils spécifiée par before.

void QMainWindow::resizeDocks(const QList<QDockWidget *> &docks, const QList<int> &sizes, Qt::Orientation orientation)

Redimensionne les widgets du dock figurant dans la liste docks en fonction des tailles correspondantes en pixels indiquées dans la liste sizes. Si orientation vaut Qt::Horizontal, la largeur est ajustée ; dans le cas contraire, c'est la hauteur des widgets du dock qui est ajustée. Les tailles seront ajustées de manière à respecter les tailles maximale et minimale, et l'QMainWindow e lui-même ne sera pas redimensionné. Tout espace supplémentaire ou manquant est réparti entre les widgets en fonction du poids relatif de leurs tailles.

Exemple :

    resizeDocks({blueWidget, yellowWidget}, {20 , 40}, Qt::Horizontal);

Si les widgets bleu et jaune sont imbriqués au même niveau, ils seront redimensionnés de manière à ce que le widget jaune soit deux fois plus grand que le widget bleu.

Si certains widgets sont regroupés dans des onglets, un seul widget par groupe doit être spécifié. Les widgets ne figurant pas dans la liste peuvent être modifiés pour respecter les contraintes.

bool QMainWindow::restoreDockWidget(QDockWidget *dockwidget)

Restaure l'état de dockwidget s'il a été créé après l'appel à restoreState(). Renvoie true si l'état a été restauré ; sinon, renvoie false.

Voir également restoreState() et saveState().

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

Restaure l'state des barres d'outils et des widgets ancrables de cette fenêtre principale. Restaure également les paramètres des coins. Le nombre version est comparé à celui stocké dans state. S'ils ne correspondent pas, l'état de la fenêtre principale reste inchangé et cette fonction renvoie false; dans le cas contraire, l'état est restauré et cette fonction renvoie true.

Pour restaurer la géométrie enregistrée à l’aide de ` QSettings`, vous pouvez utiliser un code similaire à celui-ci :

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

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

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

Enregistre l'état actuel des barres d'outils et des widgets ancrables de cette fenêtre principale. Cela inclut les paramètres de coin pouvant être définis à l'aide de la fonction setCorner(). Le numéro d'version est stocké dans les données.

La propriété ` objectName ` sert à identifier chaque ` QToolBar ` et ` QDockWidget`. Vous devez vous assurer que cette propriété est unique pour chaque ` QToolBar ` et ` QDockWidget ` que vous ajoutez à la QMainWindow

Pour restaurer l’état enregistré, transmettez la valeur de retour et le numéro version à restoreState().

Pour enregistrer la géométrie à la fermeture de la fenêtre, vous pouvez implémenter un événement de fermeture comme suit :

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

Voir également restoreState(), QWidget::saveGeometry() et QWidget::restoreGeometry().

void QMainWindow::setCentralWidget(QWidget *widget)

Définit l'widget spécifié comme widget central de la fenêtre principale.

Remarque : QMainWindow prend possession du pointeur widget et le supprime au moment opportun.

Voir aussi centralWidget().

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

Définit le widget de dock area pour qu'il occupe l'emplacement spécifié corner.

Voir également corner().

void QMainWindow::setMenuBar(QMenuBar *menuBar)

Définit la barre de menus de la fenêtre principale sur « menuBar ».

Remarque : la fonction ` QMainWindow ` prend en charge le pointeur ` menuBar ` et le supprime au moment opportun.

Voir aussi menuBar().

void QMainWindow::setMenuWidget(QWidget *menuBar)

Définit la barre de menu de la fenêtre principale sur « menuBar ».

QMainWindow Prend possession du pointeur ` menuBar ` et le supprime au moment opportun.

Voir aussi menuWidget().

void QMainWindow::setStatusBar(QStatusBar *statusbar)

Définit la barre d'état de la fenêtre principale sur « statusbar ».

Définir la barre d’état sur ` nullptr ` la supprime de la fenêtre principale. Notez que la fonction ` QMainWindow ` prend en charge le pointeur ` statusbar ` et le supprime au moment opportun.

Voir également statusBar().

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

Définit la position des onglets du widget d'ancrage areas sur la valeur spécifiée tabPosition. Par défaut, toutes les zones d'ancrage affichent leurs onglets en bas.

Voir également tabPosition() et setTabShape().

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

Divise l’espace occupé par le widget d’ancrage « first » en deux parties, déplace le widget d’ancrage « first » dans la première partie et le widget d’ancrage « second » dans la seconde partie.

L'option « orientation » (Mode de division) spécifie comment l'espace est divisé : une division « Qt::Horizontal » place le deuxième widget ancré à droite du premier ; une division « Qt::Vertical » place le deuxième widget ancré en dessous du premier.

Remarque: si first se trouve actuellement dans une zone d’ancrage à onglets, second sera ajouté en tant que nouvel onglet, et non à côté de first. En effet, un même onglet ne peut contenir qu’un seul widget d’ancrage.

Remarque: la méthode ` Qt::LayoutDirection ` influence l’ordre des widgets d’ancrage dans les deux parties de la zone divisée. Lorsque la direction de mise en page de droite à gauche est activée, l’ordre des widgets d’ancrage sera inversé.

Voir également tabifyDockWidget(), addDockWidget() et removeDockWidget().

QStatusBar *QMainWindow::statusBar() const

Renvoie la barre d'état de la fenêtre principale. Cette fonction crée et renvoie une barre d'état vide si celle-ci n'existe pas.

Voir aussi setStatusBar().

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

Renvoie la position des tabulations pour area.

Voir également ` setTabPosition()` et ` tabShape()`.

[signal] void QMainWindow::tabifiedDockWidgetActivated(QDockWidget *dockWidget)

Ce signal est émis lorsque le widget du dock à onglets est activé par la sélection de l'onglet. Le widget du dock activé est transmis via ` dockWidget`.

Voir également ` tabifyDockWidget()` et ` tabifiedDockWidgets()`.

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

Renvoie les widgets du dock regroupés sous forme d'onglets à l'aide de la fonction ` dockwidget`.

Voir aussi tabifyDockWidget().

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

Déplace le widget d'ancrage « second » au-dessus du widget d'ancrage « first », créant ainsi une zone d'ancrage à onglets à l'emplacement actuel de « first ».

Les deux widgets de dock doivent avoir été ajoutés à la fenêtre principale à l’aide de la fonction addDockWidget() avant l’appel de cette fonction, et aucun des deux ne doit déjà comporter d’onglets.

Voir également tabifiedDockWidgets() et addDockWidget().

QWidget *QMainWindow::takeCentralWidget()

Supprime le widget central de cette fenêtre principale.

La propriété du widget supprimé est transférée à l'appelant.

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

Renvoie l’ Qt::ToolBarArea pour toolbar. Si toolbar n’a pas été ajouté à la fenêtre principale, cette fonction renvoie Qt::NoToolBarArea.

Voir également addToolBar(), addToolBarBreak() et Qt::ToolBarArea.

bool QMainWindow::toolBarBreak(QToolBar *toolbar) const

Indique s'il existe une coupure de barre d'outils avant l'élément toolbar.

Voir également addToolBarBreak() et insertToolBarBreak().

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

Ce signal est émis lorsque le style utilisé pour les boutons d'outils de la fenêtre est modifié. Le nouveau style est transmis dans ` toolButtonStyle`.

Vous pouvez connecter ce signal à d’autres composants afin de garantir une apparence cohérente à votre application.

Voir également ` setToolButtonStyle()`.