QMainWindow

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 
#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 
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 
#include 
#include 
#include 
#include 
#include 
#include 
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("保存成功");
}

效果图