QMainWindow Class

Documentation des fonctions membres

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

Construit une QMainWindow avec l'adresse parent donnée et le widget spécifié flags.

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

[virtual noexcept] QMainWindow::~QMainWindow()

Détruit la fenêtre principale.

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

Ajoute l'adresse dockwidget donnée à l'adresse area spécifiée.

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

Ajoute dockwidget à area dans la direction spécifiée par orientation.

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

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

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

void QMainWindow::addToolBar(QToolBar *toolbar)

Équivalent à l'appel de addToolBar(Qt::TopToolBarArea, toolbar)

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

Crée un objet QToolBar, dont le titre de la fenêtre est title, et l'insère dans la zone supérieure de la barre d'outils.

Voir aussi setWindowTitle().

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

Ajoute une barre d'outils à l'adresse area 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 dock qui occupe l'adresse corner spécifiée.

Voir également setCorner().

[virtual] QMenu *QMainWindow::createPopupMenu()

Renvoie un menu contextuel contenant des entrées à cocher pour les barres d'outils et les widgets d'ancrage présents dans la fenêtre principale. Si aucune barre d'outils ni aucun widget d'ancrage n'est présent, 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 aussi addDockWidget(), addToolBar() et menuBar().

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

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

Voir aussi 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 de l'icône est transmise à iconSize.

Vous pouvez connecter ce signal à d'autres composants pour aider à maintenir une apparence cohérente pour votre application.

Voir également setIconSize().

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

Insère le site toolbar dans la zone occupée par la barre d'outils before de manière à ce qu'il apparaisse avant elle. Par exemple, dans une mise en page normale de gauche à droite, cela signifie que 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 barre d'outils avant la barre d'outils spécifiée par before.

QMenuBar *QMainWindow::menuBar() const

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

Si vous souhaitez que toutes les fenêtres d'une application Mac partagent une barre de menu, n'utilisez pas cette fonction pour la créer, car la barre de menu créée ici aura pour parent cette page QMainWindow. Vous devez plutôt créer une barre de menu qui n'a pas de parent et que vous pouvez ensuite partager entre toutes les fenêtres de l'application Mac. 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 cette manière :

QMenuBar *menuBar = new QMenuBar(nullptr);

Voir aussi setMenuBar().

QWidget *QMainWindow::menuWidget() const

Renvoie la barre de menu de la fenêtre principale. Cette fonction renvoie null si la barre de menu n'a pas encore été construite.

Voir aussi setMenuWidget().

void QMainWindow::removeDockWidget(QDockWidget *dockwidget)

Supprime le site dockwidget de la présentation de la fenêtre principale et le cache. Notez que le site dockwidget n' est pas supprimé.

void QMainWindow::removeToolBar(QToolBar *toolbar)

Supprime le site toolbar de la présentation de la fenêtre principale et le cache. Notez que le site toolbar n' est pas supprimé.

void QMainWindow::removeToolBarBreak(QToolBar *before)

Supprime une rupture 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 de la liste docks à la taille correspondante en pixels de la liste sizes. Si orientation est Qt::Horizontal, il ajuste la largeur, sinon il ajuste la hauteur des widgets de la station d'accueil. Les tailles seront ajustées de manière à ce que les tailles maximale et minimale soient respectées et que le site QMainWindow lui-même ne soit pas redimensionné. Tout espace supplémentaire/manquant est réparti entre les widgets en fonction du poids relatif des tailles.

Exemple :

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

Si le widget bleu et le widget jaune sont imbriqués au même niveau, ils seront redimensionnés de telle sorte que le yellowWidget soit deux fois plus grand que le blueWidget.

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(). 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 le site state des barres d'outils et des dockwidgets de cette fenêtre principale. Les paramètres d'angle sont également restaurés. Le numéro 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; sinon, l'état est restauré et cette fonction renvoie true.

Pour restaurer la géométrie sauvegardée à l'aide de QSettings, vous pouvez utiliser un code comme celui-ci :

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 actuel des barres d'outils et des dockwidgets de cette fenêtre principale. Cela inclut les paramètres d'angle qui peuvent être définis à l'aide de setCorner(). Le numéro version est stocké dans les données.

La propriété objectName est utilisée pour identifier chaque QToolBar et QDockWidget. Vous devez vous assurer que cette propriété est unique pour chaque QToolBar et QDockWidget que vous ajoutez à la fenêtre principale. QMainWindow

Pour restaurer l'état sauvegardé, passez la valeur de retour et le numéro version à restoreState().

Pour sauvegarder la géométrie lorsque la fenêtre se ferme, vous pouvez implémenter un événement de fermeture comme celui-ci :

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 widget comme le 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 donné area pour occuper l'emplacement spécifié corner.

Voir aussi corner().

void QMainWindow::setMenuBar(QMenuBar *menuBar)

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

Remarque : QMainWindow prend possession du 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)

Fixe la barre d'état de la fenêtre principale à statusbar.

En définissant la barre d'état sur nullptr, vous la supprimez de la fenêtre principale. Notez que QMainWindow prend possession du pointeur statusbar et le supprime au moment opportun.

Voir aussi statusBar().

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

Définit la position de l'onglet pour le widget dock donné areas à la position 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 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 seconde partie.

L'adresse orientation indique comment l'espace est divisé : Une division Qt::Horizontal place le deuxième dock widget à droite du premier ; une division Qt::Vertical place le deuxième dock widget 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 en tant que voisin de first, car un onglet ne peut contenir qu'un seul widget d'ancrage.

Remarque: l'adresse Qt::LayoutDirection influence l'ordre des widgets d'ancrage dans les deux parties de la zone divisée. Lorsque la mise en page de droite à gauche est activée, l'emplacement des widgets d'ancrage est 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 la barre d'état n'existe pas.

Voir aussi setStatusBar().

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

Renvoie la position de tabulation pour area.

Voir également setTabPosition() et tabShape().

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

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

Voir aussi tabifyDockWidget() et tabifiedDockWidgets().

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

Renvoie les widgets du dock qui sont tabulés avec 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 dans la fenêtre principale.

Voir aussi tabifiedDockWidgets().

QWidget *QMainWindow::takeCentralWidget()

Supprime le widget central de cette fenêtre principale.

La propriété du widget retiré est transmise à l'appelant.

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

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

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

bool QMainWindow::toolBarBreak(QToolBar *toolbar) const

Renvoie si la barre d'outils est interrompue avant l'adresse toolbar.

Voir aussi addToolBarBreak() et insertToolBarBreak().

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

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

Vous pouvez connecter ce signal à d'autres composants pour aider à maintenir une apparence cohérente pour votre application.

Voir également setToolButtonStyle().