QMainWindow
QMainWindow是一个为用户提供主窗口程序 的类，包含一个菜单栏(menu bar)、多个工具栏 (tool bars)、多个锚接部件(dock widgets)、―个 状态栏(status bar )及一个中心部件(central widget),是许多应用程序的基础，如文本编辑器、 图片编辑器等。
基本元素
1.菜单栏
菜单是一系列命令的列表。为了实现菜单、工具栏按钮、键盘快捷方式等命令 的一致性，Qt使用动作(Action)来表示这些命令。Qt的菜单就是由一系列的QAction 动作对象构成的列表，而菜单栏则是包容菜单的面板，它位于主窗口顶部、主窗口 标题栏的下面。一个主窗口最多只有一个菜单栏。
2.状态栏
状态栏通常显示GUI应用程序的一些状态信息，它位于主窗口的最底部。用户可以在状态栏上添加、使用Qt窗口部件。一个主窗口最多只有一个状态栏。
3.工具栏
工具栏是由一系列的类似于按钮的动作排列而成的面板，它通常由一些经常使 用的命令(动作)组成。工具栏的位于在菜单栏的下面、状态栏的上面，可以停靠 在主窗口的上、下、左、右四个方向上。一个主窗口可以包含多个工具栏。
4.DockWidget
DockWidget作为一个容器使用，以包容其他窗口部件来实现某些功能。例如，Qt 设计器的属性编辑器、对象监视器等都是由DockWidget包容其他的Qt窗口部件来实 现的。它位于工具栏区的内部，可以作为一个窗口自由地浮动在主窗口上面，也可 以像工具栏一样停靠在主窗口的上、下、左、右四个方向上，一个主窗口可以包含 多个DockWidget。
5.中心部件
中心部件处在锚接部件区的内部、主窗口的中心，一个主窗口只有一个中心部件。 於注意 :主窗口 QMain Window具有自己的布局管理器，因此在QMainWindow 窗口上设置布局管理器或者创建一个父窗口部件作为QMainWindow的布局管理 器都是不允许的。但可以在主窗口的中心部件上设置管理器。
为了控制主窗口工具栏和锚接部件的显隐，在默认情况下，QMainWindow主 窗口提供了一个上下文菜单(Context Menu)。通常，通过在工具栏或锚接部件上 单击鼠标右键就可以激活该上下文菜单，也可以通过函数QMainWindow:: createPopupMenu()激活该菜单。此外，还可以重写 QMainWindow::createPopupMenu() 函数，实现自定义的上下文菜单。
QMainWindow函数介绍
QMainWindow官方文档提供了如下函数（基于5.15.2版本）：
QMainWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()); //构造函数 QMainWindow本身设置Qt::Window标志，因此总是作为顶层小部件创建。 virtual ~QMainWindow(); // 析构函数 void addDockWidget(Qt::DockWidgetArea area, QDockWidget *dockwidget); // 将给定的dockwidget添加到指定区域。 void addToolBar(Qt::ToolBarArea area, QToolBar *toolbar); // 将工具栏添加到此主窗口的指定区域中。工具栏位于当前工具栏块(即行)的末尾。如果主窗口已经管理工具栏，那么它只会将工具栏移动到区域。 void addToolBar(QToolBar *toolbar); // 这是一个重载函数 QToolBar *addToolBar(const QString &title); // 这是一个重载函数 void addToolBarBreak(Qt::ToolBarArea area = Qt::TopToolBarArea); // 在所有其他对象之后的给定区域中添加工具栏分隔符。 QWidget *QMainWindow::centralWidget() const; // 返回主窗口的中心小部件。如果没有设置中心小部件，该函数返回零。 Qt::DockWidgetArea QMainWindow::dockWidgetArea(QDockWidget *dockwidget) const; // 为dockwidget返回Qt::DockWidgetArea。如果dockwidget没有被添加到主窗口，这个函数返回Qt::NoDockWidgetArea。 bool QMainWindow::event(QEvent *event); // 重载的虚函数 void QMainWindow::insertToolBar(QToolBar *before, QToolBar *toolbar); // 将工具栏插入到前面工具栏所占用的区域中，使其显示在前面。例如，在正常的从左到右布局操作中，这意味着在水平工具栏区域中，工具栏将出现在前面指定的工具栏的左侧。 void QMainWindow::insertToolBarBreak(QToolBar *before); // 在before指定的工具栏之前插入工具栏中断符。 QMenuBar *QMainWindow::menuBar() const; // 返回主窗口的菜单栏。如果菜单栏不存在，这个函数将创建并返回一个空的菜单栏。 QWidget *QMainWindow::menuWidget() const; // 返回主窗口的菜单栏。如果还没有构建菜单栏，这个函数返回null。 void QMainWindow::removeDockWidget(QDockWidget *dockwidget); // 从主窗口布局中删除dockwidget并隐藏它。注意，dockwidget没有被删除。 void QMainWindow::removeToolBar(QToolBar *toolbar); // 从主窗口布局中删除工具栏并隐藏它。注意，工具栏没有被删除。 void QMainWindow::removeToolBarBreak(QToolBar *before); // 删除先前插入的工具栏分隔符，该分隔符位于before指定的工具栏之前。 void QMainWindow::resizeDocks(const QList<QDockWidget *> &docks, const QList<int> &sizes, Qt::Orientation orientation); // 将列表底座中的底座小部件调整为列表大小的相应像素大小。如果方向为Qt::水平，则调整宽度，否则调整dock小部件的高度。 bool QMainWindow::restoreDockWidget(QDockWidget *dockwidget); // 如果dockwidget是在调用restoreState()之后创建的，则恢复它的状态。如果状态被恢复，则返回true;否则返回false。 bool QMainWindow::restoreState(const QByteArray &state, int version = 0); // 恢复主窗口的工具栏和dockwidgets的状态。 QByteArray QMainWindow::saveState(int version = 0) const; // 保存主窗口工具栏和dockwidgets的当前状态。 void QMainWindow::setCentralWidget(QWidget *widget); // 将给定的小部件设置为主窗口的中心小部件。 void QMainWindow::setCorner(Qt::Corner corner, Qt::DockWidgetArea area); // 将给定的dock小部件区域设置为占用指定的角落。 void QMainWindow::setMenuBar(QMenuBar *menuBar); // 将主窗口的菜单栏设置为menuBar。 void QMainWindow::setMenuWidget(QWidget *menuBar); // 将主窗口的菜单栏设置为menuBar。 void QMainWindow::setStatusBar(QStatusBar *statusbar); // 将主窗口的状态栏栏设置为statusbar。 void QMainWindow::setTabPosition(Qt::DockWidgetAreas areas, QTabWidget::TabPosition tabPosition); // 将给定dock小部件区域的选项卡位置设置为指定的tabPosition。 void QMainWindow::splitDockWidget(QDockWidget *first, QDockWidget *second, Qt::Orientation orientation); // 将第一个DockWidget所覆盖的空间分割为两个部分，将第一个DockWidget移动到第一个部分，并将第二个DockWidget移动到第二个部分。 QStatusBar *QMainWindow::statusBar() const; // 返回主窗口的状态栏。如果状态栏不存在，这个函数将创建并返回一个空的状态栏。 QTabWidget::TabPosition QMainWindow::tabPosition(Qt::DockWidgetArea area) const; // 返回QTabWidget位置 QList<QDockWidget *> QMainWindow::tabifiedDockWidgets(QDockWidget *dockwidget) const // 返回与dockwidget一起被归档的dock小部件。 void QMainWindow::tabifyDockWidget(QDockWidget *first, QDockWidget *second); // 将第二个停靠部件移动到第一个停靠部件的顶部，在主窗口中创建一个选项卡停靠区域。 QWidget *QMainWindow::takeCentralWidget(); // 从这个主窗口中删除中心小部件。被删除的小部件的所有权被传递给调用者。 Qt::ToolBarArea QMainWindow::toolBarArea(QToolBar *toolbar) const; // 为工具栏返回Qt::ToolBarArea。如果工具栏没有被添加到主窗口，这个函数返回Qt::NoToolBarArea。 bool QMainWindow::toolBarBreak(QToolBar *toolbar) const; // 返回工具栏之前是否有工具栏中断。
简单的示例
接下来我们使用一个简单的例子来介绍QMainWindow的使用。
例子是打开一个文本文件，将文件内容显示在界面上，修改了之后再存回文件。
**main.cpp **
#include <QApplication> #include "mainwindow.h" int main(int argc, char **argv) { QApplication app(argc, argv); MainWindow mm; mm.show(); return app.exec(); }
接下来我们来创建一个mainwindow类
相关代码介绍都在注释中。
mainwindow.h
#ifndef ALGOTEST_MAINWINDOW_H #define ALGOTEST_MAINWINDOW_H #include <QMainWindow> class QPlainTextEdit; class MainWindow : public QMainWindow { Q_OBJECT public: explicit MainWindow(QWidget *parent = 0); ~MainWindow() override; protected: void initUi(); void settings(); void createActions(); void createMenus(); void createTools(); protected slots: void openFile(); void saveFile(); private: QAction* open_file_action_; QAction* save_file_action_; QMenu* open_file_menu_; QMenuBar* menu_bar_; QStatusBar* status_bar_; QToolBar* tool_bar_; QPlainTextEdit* edit_; QString current_path_; }; #endif //ALGOTEST_MAINWINDOW_H
**mainwindow.cpp **
#include "mainwindow.h" #include <QToolBar> #include <QMenuBar> #include <QStatusBar> #include <QMenu> #include <QAction> #include <QFileDialog> #include <QPlainTextEdit> MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) { initUi(); settings(); } MainWindow::~MainWindow() { } /** * 菜单与工具栏都与QAction类密切相关，工具栏上的功能按钮与菜单中的选项 条目相对应， * 完成相同的功能，使用相同的快捷键与图标。QAction类为用户提供 了一个统一的命令接口， * 无论是从菜单触发还是从工具栏触发，或通过快捷键触发 都调用同样的操作接口，以达到同样的目的。 */ void MainWindow::initUi() { tool_bar_ = new QToolBar(this); status_bar_ = new QStatusBar(this); menu_bar_ = new QMenuBar(this); setMenuBar(menu_bar_); setStatusBar(status_bar_); addToolBar(tool_bar_); createActions(); createMenus(); createTools(); status_bar_->showMessage("create success!"); // 给界面添加一个文本编辑器 edit_ = new QPlainTextEdit(this); setCentralWidget(edit_); resize(1366, 768); } // connect 信号槽 void MainWindow::settings() { connect(open_file_action_, &QAction::triggered, this, &MainWindow::openFile); connect(save_file_action_, &QAction::triggered, this, &MainWindow::saveFile); } void MainWindow::createActions() { open_file_action_ = new QAction(tr("打开文件"), this); save_file_action_ = new QAction(tr("保存文件"), this); } /** * 菜单(Menus )的实现 * 在实现了各个动作之后，需要将它们通过菜单、工具栏或快捷键的方式体现出 来，以下是菜单的实现函数createMenus()代码： */ void MainWindow::createMenus() { open_file_menu_ = new QMenu(tr("文件"), this); open_file_menu_->addAction(open_file_action_); open_file_menu_->addAction(save_file_action_); menu_bar_->addMenu(open_file_menu_); } /** * 工具栏(ToolBars )的实现 * 接下来实现相对应的工具栏createTools(),主窗口的工具栏上可以有多个工 具条，通常釆用一个菜单对应一个工具条的方式，也可根据需要进行工具条的划分。 */ void MainWindow::createTools() { tool_bar_->addAction(open_file_action_); tool_bar_->addAction(save_file_action_); } // 打开文件槽函数 void MainWindow::openFile() { edit_->clear(); current_path_.clear(); QString fileName = QFileDialog::getOpenFileName(this, tr("打开文件"), "", "*.txt"); if(fileName.isEmpty()) { return; } current_path_ = fileName; QFile file(fileName); file.open(QIODevice::ReadOnly); edit_->insertPlainText(QString(file.readAll())); file.close(); status_bar_->showMessage("打开成功"); } // 打开文件槽函数 void MainWindow::saveFile() { if(current_path_.isEmpty()) { return; } QFile file(current_path_); file.open(QIODevice::WriteOnly); QString str = edit_->toPlainText(); file.write(str.toLocal8Bit()); file.close(); status_bar_->showMessage("保存成功"); }
效果图
