QMainWindow Class

Member Function Dokumentation

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

Konstruiert ein QMainWindow mit der angegebenen parent und dem angegebenen Widget flags.

QMainWindow setzt selbst das Flag Qt::Window und wird daher immer als Top-Level-Widget erstellt.

[virtual noexcept] QMainWindow::~QMainWindow()

Zerstört das Hauptfenster.

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

Fügt die angegebene dockwidget zu der angegebenen area hinzu.

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

Fügt dockwidget in das angegebene area in der durch orientation angegebenen Richtung ein.

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

Fügt das toolbar in das angegebene area in diesem Hauptfenster ein. Die toolbar wird an das Ende des aktuellen Symbolleistenblocks (d.h. der Zeile) gesetzt. Wenn das Hauptfenster bereits toolbar verwaltet, wird die Symbolleiste nur nach area verschoben.

Siehe auch insertToolBar(), addToolBarBreak(), und insertToolBarBreak().

void QMainWindow::addToolBar(QToolBar *toolbar)

Dies ist eine überladene Funktion.

Äquivalent zum Aufruf von addToolBar(Qt::TopToolBarArea, toolbar)

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

Dies ist eine überladene Funktion.

Erzeugt ein Objekt QToolBar, wobei der Fenstertitel auf title gesetzt wird, und fügt es in den oberen Bereich der Symbolleiste ein.

Siehe auch setWindowTitle().

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

Fügt eine Unterbrechung der Symbolleiste auf der angegebenen Seite area nach allen anderen vorhandenen Objekten ein.

QWidget *QMainWindow::centralWidget() const

Gibt das zentrale Widget für das Hauptfenster zurück. Diese Funktion gibt nullptr zurück, wenn das zentrale Widget nicht gesetzt wurde.

Siehe auch setCentralWidget().

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

Reimplements: QWidget::contextMenuEvent(QContextMenuEvent *event).

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

Gibt den Bereich des Dock-Widgets zurück, der den angegebenen corner belegt.

Siehe auch setCorner().

[virtual] QMenu *QMainWindow::createPopupMenu()

Gibt ein Popup-Menü mit ankreuzbaren Einträgen für die im Hauptfenster vorhandenen Symbolleisten und Dock-Widgets zurück. Wenn keine Symbolleisten und Dock-Widgets vorhanden sind, gibt diese Funktion nullptr zurück.

Standardmäßig wird diese Funktion vom Hauptfenster aufgerufen, wenn der Benutzer ein Kontextmenü aktiviert, typischerweise durch Rechtsklick auf eine Symbolleiste oder ein Dock-Widget.

Wenn Sie ein benutzerdefiniertes Popup-Menü erstellen möchten, implementieren Sie diese Funktion neu und geben ein neu erstelltes Popup-Menü zurück. Das Eigentum an dem Popup-Menü wird an den Aufrufer übertragen.

Siehe auch addDockWidget(), addToolBar(), und menuBar().

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

Gibt die Qt::DockWidgetArea für dockwidget zurück. Wenn dockwidget nicht zum Hauptfenster hinzugefügt wurde, gibt diese Funktion Qt::NoDockWidgetArea zurück.

Siehe auch addDockWidget(), splitDockWidget(), und Qt::DockWidgetArea.

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

Reimplements: QWidget::event(QEvent *Event).

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

Dieses Signal wird ausgegeben, wenn die Größe der im Fenster verwendeten Icons geändert wird. Die neue Symbolgröße wird in iconSize übergeben.

Sie können dieses Signal mit anderen Komponenten verbinden, um ein einheitliches Erscheinungsbild Ihrer Anwendung zu gewährleisten.

Siehe auch setIconSize().

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

Fügt toolbar in den Bereich ein, der von der Symbolleiste before belegt wird, so dass sie vor dieser erscheint. Bei normalem Links-nach-Rechts-Layout bedeutet dies zum Beispiel, dass toolbar links von der durch before angegebenen Symbolleiste in einem horizontalen Symbolleistenbereich erscheint.

Siehe auch insertToolBarBreak(), addToolBar(), und addToolBarBreak().

void QMainWindow::insertToolBarBreak(QToolBar *before)

Fügt eine Unterbrechung der Symbolleiste vor der durch before angegebenen Symbolleiste ein.

QMenuBar *QMainWindow::menuBar() const

Gibt die Menüleiste für das Hauptfenster zurück. Diese Funktion erstellt eine leere Menüleiste und gibt sie zurück, wenn die Menüleiste nicht existiert.

Wenn Sie möchten, dass alle Fenster in einem Mac-Programm eine gemeinsame Menüleiste haben, sollten Sie diese Funktion nicht verwenden, da die hier erstellte Menüleiste diese QMainWindow als übergeordnetes Fenster hat. Stattdessen müssen Sie eine Menüleiste erstellen, die kein übergeordnetes Element hat und die Sie dann für alle Mac-Fenster freigeben können. Erstellen Sie auf diese Weise eine übergeordnete Menüleiste:

QMenuBar *menuBar = new QMenuBar(nullptr);

Siehe auch setMenuBar().

QWidget *QMainWindow::menuWidget() const

Gibt die Menüleiste für das Hauptfenster zurück. Diese Funktion gibt null zurück, wenn noch keine Menüleiste erstellt wurde.

Siehe auch setMenuWidget().

void QMainWindow::removeDockWidget(QDockWidget *dockwidget)

Entfernt dockwidget aus dem Layout des Hauptfensters und blendet es aus. Beachten Sie, dass dockwidget nicht gelöscht wird.

void QMainWindow::removeToolBar(QToolBar *toolbar)

Entfernt toolbar aus dem Layout des Hauptfensters und blendet es aus. Beachten Sie, dass toolbar nicht gelöscht wird.

void QMainWindow::removeToolBarBreak(QToolBar *before)

Entfernt eine Symbolleistenunterbrechung, die vor der durch before angegebenen Symbolleiste eingefügt wurde.

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

Passt die Größe der Dock-Widgets in der Liste docks an die entsprechende Größe in Pixeln aus der Liste sizes an. Wenn orientation gleich Qt::Horizontal ist, wird die Breite, ansonsten die Höhe der Dock-Widgets angepasst. Die Größen werden so angepasst, dass die Maximal- und Minimalgrößen eingehalten werden und die Größe von QMainWindow selbst nicht verändert wird. Jeglicher zusätzliche/fehlende Platz wird unter den Widgets entsprechend dem relativen Gewicht der Größen verteilt.

Beispiel:

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

Wenn das blaue und das gelbe Widget auf derselben Ebene verschachtelt sind, wird ihre Größe so angepasst, dass das gelbe Widget doppelt so groß ist wie das blaue Widget.

Wenn einige Widgets in Registerkarten gruppiert sind, sollte nur ein Widget pro Gruppe angegeben werden. Widgets, die nicht in der Liste enthalten sind, können geändert werden, um die Beschränkungen einzuhalten.

bool QMainWindow::restoreDockWidget(QDockWidget *dockwidget)

Stellt den Zustand von dockwidget wieder her, wenn es nach dem Aufruf von restoreState() erstellt wurde. Gibt true zurück, wenn der Zustand wiederhergestellt wurde; andernfalls false.

Siehe auch restoreState() und saveState().

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

Stellt die state für die Symbolleisten und Dockwidgets dieses Hauptfensters wieder her. Stellt auch die Eckeinstellungen wieder her. Die Nummer version wird mit der in state gespeicherten Nummer verglichen. Wenn sie nicht übereinstimmen, bleibt der Zustand des Hauptfensters unverändert und diese Funktion gibt false zurück; andernfalls wird der Zustand wiederhergestellt und diese Funktion gibt true zurück.

Um die mit QSettings gespeicherte Geometrie wiederherzustellen, können Sie Code wie den folgenden verwenden:

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

Siehe auch saveState(), QWidget::saveGeometry(), QWidget::restoreGeometry(), und restoreDockWidget().

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

Speichert den aktuellen Zustand der Symbolleisten und Dockwidgets dieses Hauptfensters. Dazu gehören auch die Eckeinstellungen, die mit setCorner() gesetzt werden können. Die Nummer version wird als Teil der Daten gespeichert.

Die Eigenschaft objectName wird verwendet, um jedes QToolBar und QDockWidget zu identifizieren. Sie sollten sicherstellen, dass diese Eigenschaft für jedes QToolBar und QDockWidget, das Sie dem Hauptfenster hinzufügen, eindeutig ist. QMainWindow

Um den gespeicherten Zustand wiederherzustellen, übergeben Sie den Rückgabewert und die Nummer version an restoreState().

Um die Geometrie zu speichern, wenn das Fenster geschlossen wird, können Sie ein close-Ereignis wie dieses implementieren:

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

Siehe auch restoreState(), QWidget::saveGeometry(), und QWidget::restoreGeometry().

void QMainWindow::setCentralWidget(QWidget *widget)

Setzt das angegebene widget auf das zentrale Widget des Hauptfensters.

Hinweis: QMainWindow übernimmt den Besitz des Zeigers widget und löscht ihn zu gegebener Zeit.

Siehe auch centralWidget().

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

Setzt das angegebene Dock-Widget area so, dass es den angegebenen corner belegt.

Siehe auch corner().

void QMainWindow::setMenuBar(QMenuBar *menuBar)

Setzt die Menüleiste für das Hauptfenster auf menuBar.

Hinweis: QMainWindow übernimmt den Zeiger menuBar und löscht ihn zu gegebener Zeit.

Siehe auch menuBar().

void QMainWindow::setMenuWidget(QWidget *menuBar)

Setzt die Menüleiste für das Hauptfenster auf menuBar.

QMainWindow übernimmt den Zeiger menuBar und löscht ihn zu gegebener Zeit.

Siehe auch menuWidget().

void QMainWindow::setStatusBar(QStatusBar *statusbar)

Setzt die Statusleiste für das Hauptfenster auf statusbar.

Wenn Sie die Statusleiste auf nullptr setzen, wird sie aus dem Hauptfenster entfernt. Beachten Sie, dass QMainWindow den Zeiger statusbar übernimmt und ihn zu gegebener Zeit löscht.

Siehe auch statusBar().

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

Setzt die Registerkartenposition für das angegebene Dock-Widget areas auf die angegebene tabPosition. Standardmäßig zeigen alle Dockbereiche ihre Registerkarten am unteren Rand an.

Siehe auch tabPosition() und setTabShape().

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

Teilt den vom Andock-Widget first abgedeckten Bereich in zwei Teile, verschiebt das Andock-Widget first in den ersten Teil und verschiebt das Andock-Widget second in den zweiten Teil.

Die orientation gibt an, wie der Bereich aufgeteilt wird: Eine Qt::Horizontal Teilung platziert das zweite Dock-Widget rechts vom ersten; eine Qt::Vertical Teilung platziert das zweite Dock-Widget unter das erste.

Hinweis: Wenn sich first derzeit in einem angedockten Bereich mit Registerkarten befindet, wird second als neue Registerkarte hinzugefügt, nicht als Nachbar von first. Dies liegt daran, dass eine einzelne Registerkarte nur ein Andock-Widget enthalten kann.

Hinweis: Qt::LayoutDirection beeinflusst die Reihenfolge der Docking-Widgets in den beiden Teilen des geteilten Bereichs. Wenn die Layout-Richtung von rechts nach links aktiviert ist, wird die Platzierung der Dock-Widgets umgedreht.

Siehe auch tabifyDockWidget(), addDockWidget(), und removeDockWidget().

QStatusBar *QMainWindow::statusBar() const

Gibt die Statusleiste für das Hauptfenster zurück. Diese Funktion erstellt eine leere Statusleiste und gibt sie zurück, wenn die Statusleiste nicht existiert.

Siehe auch setStatusBar().

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

Gibt die Tabulatorposition für area zurück.

Siehe auch setTabPosition() und tabShape().

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

Dieses Signal wird ausgegeben, wenn das Dock-Widget mit Registerkarten durch Auswahl der Registerkarte aktiviert wird. Das aktivierte Dock-Widget wird in dockWidget übergeben.

Siehe auch tabifyDockWidget() und tabifiedDockWidgets().

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

Gibt die Dock-Widgets zurück, die zusammen mit dockwidget tabelliert sind.

Siehe auch tabifyDockWidget().

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

Verschiebt das Andock-Widget second über das Andock-Widget first, wodurch ein angedockter Bereich mit Registerkarten im Hauptfenster entsteht.

Siehe auch tabifiedDockWidgets().

QWidget *QMainWindow::takeCentralWidget()

Entfernt das zentrale Widget aus diesem Hauptfenster.

Der Eigentümer des entfernten Widgets wird an den Aufrufer übergeben.

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

Gibt die Qt::ToolBarArea für toolbar zurück. Wenn toolbar nicht zum Hauptfenster hinzugefügt wurde, gibt diese Funktion Qt::NoToolBarArea zurück.

Siehe auch addToolBar(), addToolBarBreak(), und Qt::ToolBarArea.

bool QMainWindow::toolBarBreak(QToolBar *toolbar) const

Gibt zurück, ob es vor toolbar eine Unterbrechung der Symbolleiste gibt.

Siehe auch addToolBarBreak() und insertToolBarBreak().

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

Dieses Signal wird ausgegeben, wenn der für die Werkzeugschaltflächen im Fenster verwendete Stil geändert wird. Der neue Stil wird in toolButtonStyle übergeben.

Sie können dieses Signal mit anderen Komponenten verbinden, um ein einheitliches Erscheinungsbild Ihrer Anwendung zu gewährleisten.

Siehe auch setToolButtonStyle().