QMainWindow Class

成员函数文档

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

用给定的parent 和指定的 widgetflags 构造一个 QMainWindow。

QMainWindow 本身会设置Qt::Window 标志，因此将始终作为顶级 widget 创建。

[virtual noexcept] QMainWindow::~QMainWindow()

销毁主窗口。

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

将给定的dockwidget 添加到指定的area 中。

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

按orientation 指定的方向将dockwidget 添加到给定的area 中。

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

将toolbar 添加到主窗口中指定的area 中。toolbar 放在当前工具栏块（即行）的末尾。如果主窗口已管理toolbar ，则只会将工具栏移至area 。

另请参阅 insertToolBar(),addToolBarBreak() 和insertToolBarBreak()。

void QMainWindow::addToolBar(QToolBar *toolbar)

这是一个重载函数。

等同于调用 addToolBar(Qt::TopToolBarArea,toolbar)

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

这是一个重载函数。

创建QToolBar 对象，将其窗口标题设为title ，并将其插入顶部工具栏区域。

另请参见 setWindowTitle().

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

在给定的area 中，在所有其他对象之后添加工具栏断点。

QWidget *QMainWindow::centralWidget() const

返回主窗口的中心部件。如果未设置中心窗口部件，该函数将返回nullptr 。

另请参见 setCentralWidget()。

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

重实现：QWidget::contextMenuEvent(QContextMenuEvent *event).

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

返回占据指定corner 的 dock widget 区域。

另请参阅 setCorner() 。

[virtual] QMenu *QMainWindow::createPopupMenu()

返回一个弹出菜单，其中包含主窗口中存在的工具栏和停靠窗口小部件的可选中条目。如果没有工具栏和停靠窗口小部件，该函数将返回nullptr 。

默认情况下，主窗口会在用户激活上下文菜单时调用该函数，通常是右键单击工具栏或停靠窗口部件。

如果要创建自定义弹出菜单，请重新实现此函数并返回一个新创建的弹出菜单。弹出菜单的所有权将转移给调用者。

另请参阅 addDockWidget()、addToolBar() 和menuBar()。

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

返回dockwidget 的Qt::DockWidgetArea 。如果dockwidget 尚未添加到主窗口，该函数将返回Qt::NoDockWidgetArea 。

另请参阅 addDockWidget(),splitDockWidget() 和Qt::DockWidgetArea 。

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

重实现：QWidget::event(QEvent *event).

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

当窗口中使用的图标大小发生变化时，会发出该信号。新的图标大小在iconSize 中传递。

您可以将此信号连接到其他组件，以帮助应用程序保持一致的外观。

另请参阅 setIconSize() 。

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

将toolbar 插入before 工具栏占用的区域，使其出现在 工具栏之前。例如，在正常的从左到右布局操作中，这意味着toolbar 将出现在水平工具栏区域中before 指定的工具栏的左边。

另请参阅 insertToolBarBreak()、addToolBar() 和addToolBarBreak()。

void QMainWindow::insertToolBarBreak(QToolBar *before)

在before 指定的工具栏之前插入工具栏分隔符。

QMenuBar *QMainWindow::menuBar() const

返回主窗口的菜单栏。如果菜单栏不存在，该函数将创建并返回一个空菜单栏。

如果希望 Mac 应用程序中的所有窗口共享一个菜单栏，请不要使用此函数来创建，因为此处创建的菜单栏将以QMainWindow 作为父级菜单栏。相反，您必须创建一个没有父菜单栏的菜单栏，然后在所有 Mac 窗口中共享。用这种方法创建一个无父菜单栏：

QMenuBar *menuBar = new QMenuBar(nullptr);

另请参阅 setMenuBar().

QWidget *QMainWindow::menuWidget() const

返回主窗口的菜单栏。如果尚未构建菜单栏，该函数将返回空值。

另请参见 setMenuWidget()。

void QMainWindow::removeDockWidget(QDockWidget *dockwidget)

从主窗口布局中删除并隐藏dockwidget 。请注意，dockwidget 不会被删除。

void QMainWindow::removeToolBar(QToolBar *toolbar)

从主窗口布局中删除并隐藏toolbar 。请注意，toolbar 不会被删除。

void QMainWindow::removeToolBarBreak(QToolBar *before)

删除before 指定的工具栏之前插入的工具栏断点。

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

将docks 列表中的 dock 部件调整为sizes 列表中相应的像素大小。如果orientation 是Qt::Horizontal ，则调整宽度，否则调整 dock 部件的高度。调整尺寸时，将遵守最大和最小尺寸，而不会调整QMainWindow 本身的大小。任何额外/缺失的空间都会根据尺寸的相对权重在部件之间分配。

例如

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

如果蓝色和黄色窗口小部件嵌套在同一层级，它们的大小将被调整为黄色窗口小部件是蓝色窗口小部件的两倍。

如果某些部件在标签页中分组，则每个组只能指定一个部件。不在列表中的部件可能会被修改，以符合约束条件。

bool QMainWindow::restoreDockWidget(QDockWidget *dockwidget)

如果dockwidget 是在调用restoreState() 之后创建的，则恢复 的状态。如果状态已恢复，则返回true ；否则返回false 。

另请参阅 restoreState() 和saveState()。

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

恢复主窗口工具栏和 dockwidget 的state 。同时也会恢复边角设置。将version 与state 中存储的数字进行比较。如果两者不匹配，主窗口的状态保持不变，此函数返回false ；否则，恢复状态，此函数返回true 。

要恢复使用QSettings 保存的几何图形，可以使用如下代码：

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

另请参见 saveState()、QWidget::saveGeometry()、QWidget::restoreGeometry() 和restoreDockWidget()。

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

保存主窗口工具栏和 dockwidget 的当前状态。其中包括可通过setCorner() 设置的边角设置。version 编号作为数据的一部分保存。

objectName 属性用于标识每个QToolBar 和QDockWidget 。应确保添加到主窗口的每个QToolBar 和QDockWidget 的属性都是唯一的。QMainWindow

要恢复已保存的状态，请将返回值和version 编号传递给restoreState() 。

要在窗口关闭时保存几何图形，可以像这样实现关闭事件：

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

另请参阅 restoreState()、QWidget::saveGeometry() 和QWidget::restoreGeometry()。

void QMainWindow::setCentralWidget(QWidget *widget)

将给定的widget 设置为主窗口的中心部件。

注意：QMainWindow 拥有widget 指针的所有权，并在适当时候将其删除。

另请参阅 centralWidget() 。

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

设置给定的 dock widgetarea 占用指定的corner 。

另请参阅 corner() 。

void QMainWindow::setMenuBar(QMenuBar *menuBar)

将主窗口的菜单栏设置为menuBar 。

注：QMainWindow 拥有menuBar 指针的所有权，并在适当时候将其删除。

另请参阅 menuBar() 。

void QMainWindow::setMenuWidget(QWidget *menuBar)

将主窗口的菜单栏设置为menuBar 。

QMainWindow 获取 指针的所有权，并在适当的时候将其删除。menuBar

另请参阅 menuWidget().

void QMainWindow::setStatusBar(QStatusBar *statusbar)

将主窗口的状态栏设置为statusbar 。

将状态栏设置为nullptr 将从主窗口中删除状态栏。请注意，QMainWindow 会获取statusbar 指针的所有权，并在适当时候将其删除。

另请参阅 statusBar() 。

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

将给定 dock widgetareas 的标签页位置设置为指定的tabPosition 。默认情况下，所有 dock 区域的标签页都显示在底部。

另请参阅 tabPosition() 和setTabShape()。

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

将first dock widget 覆盖的空间分成两部分，将first dock widget 移到第一部分，并将second dock widget 移到第二部分。

orientation 指定了空间的分割方式：Qt::Horizontal 分割后，第二个停靠窗口部件位于第一个停靠窗口部件的右侧；Qt::Vertical 分割后，第二个停靠窗口部件位于第一个停靠窗口部件的下方。

注意：如果first 当前位于一个标签页停靠区，second 将作为一个新标签页添加，而不是作为first 的邻接页添加。这是因为一个标签页只能包含一个停靠部件。

注意：Qt::LayoutDirection 会影响停靠窗口小部件在划分区域两部分中的顺序。如果启用了从右到左的布局方向，dock widget 的位置就会颠倒。

另请参阅 tabifyDockWidget()、addDockWidget() 和removeDockWidget()。

QStatusBar *QMainWindow::statusBar() const

返回主窗口的状态栏。如果状态栏不存在，该函数将创建并返回一个空状态栏。

另请参阅 setStatusBar()。

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

返回area 的制表符位置。

另请参阅 setTabPosition() 和tabShape()。

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

当选择标签激活标签化 dock 部件时，就会发出该信号。激活的 dock 部件在dockWidget 中传递。

另请参阅 tabifyDockWidget() 和tabifiedDockWidgets() 。

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

Returns the dock widgets that are tabified together withdockwidget 。

另请参阅 tabifyDockWidget() 。

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

将second 停靠窗口部件移到first 停靠窗口部件的顶部，在主窗口中创建一个标签式停靠区域。

另请参阅 tabifiedDockWidgets().

QWidget *QMainWindow::takeCentralWidget()

删除主窗口中的中心部件。

被移除 Widget 的所有权将传递给调用者。

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

返回toolbar 的Qt::ToolBarArea 。如果toolbar 尚未添加到主窗口，该函数将返回Qt::NoToolBarArea 。

另请参阅 addToolBar(),addToolBarBreak() 和Qt::ToolBarArea 。

bool QMainWindow::toolBarBreak(QToolBar *toolbar) const

返回toolbar 之前是否有工具栏中断。

另请参阅 addToolBarBreak() 和insertToolBarBreak() 。

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

当窗口中工具按钮的样式发生变化时，将发出该信号。新样式在toolButtonStyle 中传递。

您可以将此信号连接到其他组件，以帮助应用程序保持一致的外观。

另请参阅 setToolButtonStyle() 。