QMainWindow Class

Dokumentation der Mitgliedsfunktionen

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

Erstellt ein QMainWindow mit dem angegebenen Flag „ parent “ und dem angegebenen Widget- flags.

QMainWindow setzt das Flag „ Qt::Window “ selbst und wird daher immer als Widget der obersten Ebene erstellt.

[virtual noexcept] QMainWindow::~QMainWindow()

Schließt das Hauptfenster.

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

Fügt die angegebene „ dockwidget “ zur angegebenen „ area “ im Hauptfenster hinzu.

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

Fügt dockwidget in die angegebene area in der durch orientation festgelegten Richtung ein.

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

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

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

void QMainWindow::addToolBar(QToolBar *toolbar)

Entspricht dem Aufruf von addToolBar(Qt::TopToolBarArea, toolbar)

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

Erstellt ein „ QToolBar “-Objekt, setzt dessen Fenstertitel auf „ title “ und fügt es in den oberen Symbolleistenbereich ein.

Siehe auch ` setWindowTitle()`.

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

Fügt nach allen anderen vorhandenen Objekten eine Symbolleistenunterbrechung in die angegebene „ area “ 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 noch nicht festgelegt wurde.

Siehe auch „ setCentralWidget()“.

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

Implementiert: ` QWidget::contextMenuEvent` (`QContextMenuEvent *event`).

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

Gibt den Dock-Widget-Bereich zurück, der den angegebenen Bereich corner einnimmt.

Siehe auch setCorner().

[virtual] QMenu *QMainWindow::createPopupMenu()

Gibt ein Popup-Menü zurück, das auswählbare Einträge für die im Hauptfenster vorhandenen Symbolleisten und Dock-Widgets enthält. Sind keine Symbolleisten und Dock-Widgets vorhanden, gibt diese Funktion „ nullptr “ zurück.

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

Wenn Sie ein benutzerdefiniertes Popup-Menü erstellen möchten, implementieren Sie diese Funktion neu und geben Sie ein neu erstelltes Popup-Menü zurück. Die Eigentumsrechte am Popup-Menü werden auf den Aufrufer übertragen.

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

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

Gibt den „ 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)

Umsetzt: ` QWidget::event(QEvent *event)`.

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

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

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

Siehe auch ` setIconSize()`.

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

Fügt die „ toolbar “ in den Bereich ein, der von der Symbolleiste „ before “ belegt wird, sodass sie vor dieser angezeigt wird. Im normalen Layoutbetrieb von links nach rechts bedeutet dies beispielsweise, dass „ toolbar “ in einem horizontalen Symbolleistenbereich links neben der durch „ before “ angegebenen Symbolleiste angezeigt wird.

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

void QMainWindow::insertToolBarBreak(QToolBar *before)

Fügt einen Symbolleistenumbruch 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, falls noch keine Menüleiste vorhanden ist.

Wenn Sie möchten, dass alle Fenster einer Mac-Anwendung eine gemeinsame Menüleiste nutzen, sollten Sie diese Funktion nicht zum Erstellen der Menüleiste verwenden, da die hier erstellte Menüleiste „ QMainWindow “ als übergeordnete Instanz hat. Stattdessen müssen Sie eine Menüleiste ohne übergeordnete Instanz erstellen, die dann von allen Mac-Fenstern gemeinsam genutzt werden kann. Erstellen Sie eine Menüleiste ohne übergeordnete Instanz wie folgt:

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 den „ dockwidget “ aus dem Layout des Hauptfensters und blendet ihn aus. Beachten Sie, dass der „ dockwidget “ nicht gelöscht wird.

void QMainWindow::removeToolBar(QToolBar *toolbar)

Entfernt den „ toolbar “ aus dem Layout des Hauptfensters und blendet ihn aus. Beachten Sie, dass der „ toolbar “ nicht gelöscht wird.

void QMainWindow::removeToolBarBreak(QToolBar *before)

Entfernt eine zuvor vor der durch ` before` angegebenen Symbolleiste eingefügte Symbolleistenunterbrechung.

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

Passen Sie die Größe der Dock-Widgets im Listen docks an die entsprechende Größe in Pixeln aus der Liste sizes an. Wenn orientation gleich Qt::Horizontal ist, wird die Breite angepasst, andernfalls die Höhe der Dock-Widgets. Die Größen werden so angepasst, dass die maximalen und minimalen Größen eingehalten werden und die Größe des QMainWindow s selbst nicht verändert wird. Etwaiger zusätzlicher oder fehlender Platz wird entsprechend dem relativen Gewichtsanteil der Größen auf die Widgets verteilt.

Beispiel:

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

Wenn das blaue und das gelbe Widget auf derselben Ebene verschachtelt sind, werden sie so in der Größe angepasst, dass das yellowWidget doppelt so groß ist wie das blueWidget

Wenn einige Widgets in Registerkarten gruppiert sind, sollte nur ein Widget pro Gruppe angegeben werden. Widgets, die nicht in der Liste aufgeführt sind, werden möglicherweise angepasst, um die Vorgaben einzuhalten.

bool QMainWindow::restoreDockWidget(QDockWidget *dockwidget)

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

Siehe auch restoreState() und saveState().

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

Stellt die „ state “ der Symbolleisten und Dock-Widgets dieses Hauptfensters wieder her. Außerdem werden die Ecken-Einstellungen wiederhergestellt. Die Zahl „ version “ wird mit der in „ state “ gespeicherten Zahl verglichen. Stimmen diese nicht überein, 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 folgenden Code 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 Dock-Widgets dieses Hauptfensters. Dazu gehören auch die Ecken-Einstellungen, die mit ` setCorner()` festgelegt werden können. Die Nummer ` version ` wird als Teil der Daten gespeichert.

Die Eigenschaft „ objectName “ dient zur Identifizierung jedes „ QToolBar “ und „ QDockWidget “. Sie sollten sicherstellen, dass diese Eigenschaft für jedes „ QToolBar “ und „ QDockWidget “, das Sie zur QMainWindow

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

Um die Geometrie beim Schließen des Fensters zu speichern, können Sie ein Schließen-Ereignis wie folgt 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)

Legt das angegebene „ widget “ als zentrales Widget des Hauptfensters fest.

Hinweis: „ QMainWindow “ übernimmt die Verantwortung für den Zeiger „ widget “ und löscht ihn zum geeigneten Zeitpunkt.

Siehe auch ` centralWidget()`.

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

Legt fest, dass das angegebene Dock-Widget „ area “ den angegebenen Bereich „ corner “ einnimmt.

Siehe auch corner().

void QMainWindow::setMenuBar(QMenuBar *menuBar)

Setzt die Menüleiste des Hauptfensters auf „ menuBar “.

Hinweis: „ QMainWindow “ übernimmt die Verantwortung für den Zeiger „ menuBar “ und löscht ihn zum geeigneten Zeitpunkt.

Siehe auch „ menuBar()“.

void QMainWindow::setMenuWidget(QWidget *menuBar)

Setzt die Menüleiste des Hauptfensters auf „ menuBar “.

QMainWindow Übernimmt die Verantwortung für den Zeiger „ menuBar “ und löscht ihn zum geeigneten Zeitpunkt.

Siehe auch ` menuWidget()`.

void QMainWindow::setStatusBar(QStatusBar *statusbar)

Setzt die Statusleiste des Hauptfensters auf „ statusbar “.

Durch das Setzen der Statusleiste auf „ nullptr “ wird diese aus dem Hauptfenster entfernt. Beachten Sie, dass „ QMainWindow “ die Verantwortung für den Zeiger „ statusbar “ übernimmt und diesen zum geeigneten Zeitpunkt löscht.

Siehe auch ` statusBar()`.

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

Legt die Registerkartenposition für das angegebene Dock-Widget „ areas “ auf die angegebene Position „ tabPosition “ fest. Standardmäßig werden die Registerkarten aller Dock-Bereiche unten angezeigt.

Siehe auch „ tabPosition()“ und „ setTabShape()“.

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

Teilt den vom Dock-Widget „ first “ eingenommenen Bereich in zwei Teile, verschiebt das Dock-Widget „ first “ in den ersten Teil und das Dock-Widget „ second “ in den zweiten Teil.

Die Option „ orientation “ legt fest, wie der Bereich aufgeteilt wird: Bei einer Aufteilung nach „ Qt::Horizontal “ wird das zweite Dock-Widget rechts neben dem ersten platziert; bei einer Aufteilung nach „ Qt::Vertical “ wird das zweite Dock-Widget unterhalb des ersten platziert.

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

Hinweis: Das „ Qt::LayoutDirection “ beeinflusst die Reihenfolge der Dock-Widgets in den beiden Teilen des geteilten Bereichs. Wenn die Layout-Richtung von rechts nach links aktiviert ist, wird die Anordnung der Dock-Widgets umgekehrt.

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, falls noch keine Statusleiste vorhanden ist.

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 ausgelöst, wenn das als Registerkarte dargestellte Dock-Widget durch Auswahl der Registerkarte aktiviert wird. Das aktivierte Dock-Widget wird an ` dockWidget` übergeben.

Siehe auch ` tabifyDockWidget()` und ` tabifiedDockWidgets()`.

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

Gibt die Dock-Widgets zurück, die zusammen mit „ dockwidget “ in Registerkarten unterteilt sind.

Siehe auch „ tabifyDockWidget()“.

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

Verschiebt das Dock-Widget „ second “ über das Dock-Widget „ first “ und erstellt so einen Dock-Bereich mit Registerkarten an der aktuellen Position von „ first “.

Beide Dock-Widgets müssen vor dem Aufruf dieser Funktion mit ` addDockWidget()` zum Hauptfenster hinzugefügt worden sein, und keines von beiden darf bereits mit Registerkarten versehen sein.

Siehe auch tabifiedDockWidgets() und addDockWidget().

QWidget *QMainWindow::takeCentralWidget()

Entfernt das zentrale Widget aus diesem Hauptfenster.

Die Verantwortung für das entfernte Widget wird an den Aufrufer übergeben.

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

Gibt den „ 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 vor dem ` toolbar` ein Toolbar-Umbruch vorhanden ist.

Siehe auch „ addToolBarBreak()“ und „ insertToolBarBreak()“.

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

Dieses Signal wird ausgelöst, 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 verknüpfen, um ein einheitliches Erscheinungsbild Ihrer Anwendung zu gewährleisten.

Siehe auch ` setToolButtonStyle()`.