QT入门之QMainWindow

QMainWindow

1 简介
2 Menu Bar
- 2.1 简单示例
3 状态栏
- 3.1 示例
4 工具栏
- 4.1 简单示例
- 4.3 设置方向和工具栏中组件的排列方向
- 4.4 设置固定方向
- 4.5 addToolBarBreak()
5 setCentralWidget() 设置中心区域
6 QDockWidget
- 6.1 setFeatures()
7 保存 / 设置窗口状态
- 7.1 简单示例：
8 完整代码

1 简介

在桌面程序中，任何软件都有界面，界面就是与用户交互的，一般体现为窗口。在 QT 中通过继承 QMainWindow 来实现自定义的窗口，并为我们规划好了一个窗口大致包含的几个部分：顶部的菜单栏、底部的状态栏、外圈环绕的工具栏、内圈环绕的可悬浮的窗口部件以及最中心的中心部件。如下图：

下面就依次介绍一下 QMainWindow 中各个组件的 UI 效果及作用，这里只是简单的介绍一下，让大家有个印象，后面的文章再逐个详细的介绍。

2 Menu Bar

在菜单中栏中，

可以添加多个菜单，但是菜单并不负责执行具体的操作，而是在菜单中添加不同的 “动作”(QAction)来完成。
在菜单栏中除了添加菜单，还可以直接添加 QAction。

2.1 简单示例

MainWindow.h ：

class MainWindow : public QMainWindow
{Q_OBJECTprivate slots:void newActTriggered();void operateActTriggered();public:QMenuBar *mBar;//菜单栏QMenu *fileMenu;QMenu *editMenu;QAction *newAct;QAction *operateAct;MainWindow(QWidget *parent = 0);void createMenus();
};

MainWindow.cpp:
本段代码主要完成在菜单栏中：

添加一个 “文件” 菜单，并在文件菜单中添加一个 “new” 菜单项
添加一个 “编辑”菜单，但是给菜单没有菜单项
添加一个 “操作” 动作。

#include "mainwindow.h"
#include "qdebug.h"
void MainWindow::createMenus(){mBar = menuBar();//获取菜单栏fileMenu = mBar->addMenu(tr("文件"));//创建文件菜单editMenu = mBar->addMenu(tr("编辑"));//创建编辑菜单//在菜单栏中添加一个 QAction 并指定 triggered() 信号的槽函数operateAct = mBar->addAction(tr("操作"),this,SLOT(operateActTriggered()));//在文件菜单中添加 new 菜单子项newAct = new QAction("new");fileMenu->addAction(newAct);connect(this->newAct,SIGNAL(triggered()),this,SLOT(newActTriggered()));
}
//当 new 菜单子项被点击时执行
void MainWindow::newActTriggered(){qDebug()<<"newActTriggered()";
}
//当 操作 被点击时执行
void MainWindow::operateActTriggered(){qDebug()<<"operateTriggered()";
}MainWindow::MainWindow(QWidget *parent): QMainWindow(parent)
{createMenus();
}

运行结果如下：

当我们点击 “new” 时就会在控制台输出：

newActTriggered()

当我们点击 “操作” 时就会在控制台输出：

operateTriggered()

我们除了可以通过 menuBar() 方法获取一个系统为我们创建好的 QMenuBar 对象外，我们也可以自己创建一个 QMenuBar 对象，再通过 setMenuBar() 将它设置到 MainWindow 中。

3 状态栏

一般的桌面软件，在窗口界面的左下角或者最下面都是有一个状态栏的，一般显示文本编辑器中此时光标的位置，或当前文件的名称等等。在 qt 中，我们也可以给 QMainWindow 设置状态栏。

3.1 示例

void MainWindow::createStatusBar(){sBar = statusBar();//获取窗口的状态栏对象 QStatusBar 实例。sBar->showMessage(tr("这里是状态栏"),0);//状态栏显示的文本
}

4 工具栏

一般软件中，工具栏也是由一些可点击的“动作”组成的，与菜单栏不同的是，工具栏一般都是些可点击的图标，在 UI 交互上，给用户一种更加直观的感觉。

我们看一下 NodePad++ 的界面做一个简单的认识：

4.1 简单示例

接下来我们就看一下如何用 QT 给窗口添加工具栏。

void MainWindow::showToolBar(){fileToolBar = addToolBar(tr("文件工具"));fileToolBar->addAction(newAct);
}

在这个案例中我们通过 QMainWindow 的 addToolBar() 方法向窗口中添加一个工具栏，然后再在窗口中添加了一个 QAction 。这个 newAct 是我们前面定义的，它一样可以被点击，并执行槽函数。

运行结果：这个我们的工具栏就是很简单的文字，大家可以给它添加一些有图标的QAction 就可以了。

并且现在这个工具栏我们可以随意拖动到窗口的下方、右方、左方。

这也就是为什么，在介绍 QMainWindow 的各个组件的时候，QToolBar 是占了一圈的原因，工具栏可以随意的放在四个方向。

4.3 设置方向和工具栏中组件的排列方向

我们可以通过 fileToolBar->setMovable(false); 方法将工具栏固定住，用户就不能随意拖动了。
也可通过 fileToolBar->setOrientation(Qt::Horizontal); 方法设置工具栏中的各个组件为水平排列，Qt::Vertical 为竖直方向。

4.4 设置固定方向

通过 addToolBar(const QString &title); 默认是在上方的，且不能再设置位置了。可以通过addToolBar(Qt::ToolBarArea area, QToolBar *toolbar); 方法将一个工具栏添加到指定的位置上：

 ediToolBar = new QToolBar(tr("操作工具"));ediToolBar->addAction(operateAct);ediToolBar->addAction(newAct);ediToolBar->setMovable(false);addToolBar(Qt::RightToolBarArea,ediToolBar);//添加到右边

4.5 addToolBarBreak()

addToolBarBreak(); 使工具栏之间添加一个间隔。

void MainWindow::showToolBar(){fileToolBar = addToolBar(tr("文件工具"));fileToolBar->setMovable(false);fileToolBar->addAction(newAct);addToolBarBreak(Qt::TopToolBarArea);//Qt::TopToolBarArea 两个工具栏上下排列ediToolBar = new QToolBar(tr("操作工具"));ediToolBar->addAction(operateAct);ediToolBar->addAction(newAct);ediToolBar->setMovable(false);addToolBar(ediToolBar);
}

这两个工具栏中间有一条横线间隔，且这两个工具栏是上下方向排列的。
默认情况下是左右方向的：

5 setCentralWidget() 设置中心区域

顾名思义，中心区域就是窗口最中心的地方，一般是用户主要操作的地方，比如，前面的 NodePad++ 的中心区域就是用户编辑文本的地方。

//将一个给定的 QWidget 作为中心区域
void QMainWindow::setCentralWidget(QWidget *widget)
//获取系统创建的中心区域
QWidget *QMainWindow::centralWidget() const

从这两个方法可以看出，只要是一个 widget 都可以作为中心区域。
简单示例：将一个 TextEdit 文本编辑框作为 centralWidget

void MainWindow::showCentralWidget(){centerTextEdit=new QTextEdit(this);centerTextEdit->setText(tr("这里是中心区域"));centerTextEdit->setAlignment(Qt::AlignCenter);setCentralWidget(centerTextEdit);
}

中间的文本编辑框就是我们的中心区域了，它在菜单栏、工具栏的下面，在状态栏的上面。

6 QDockWidget

QDockWidget类提供了一个特殊的窗口部件，它可以是被锁在 QMainWindow 窗口内部或者是作为顶级窗口悬浮在桌面上。
它可以围绕在中心区域的四周，即四个方向都可以放置，与工具栏类似。

先看一个简单的示例：

void MainWindow::showDockWidget(){dock1 = new QDockWidget(tr("dock1"),this);dock1->setFeatures(QDockWidget::DockWidgetMovable);dock1->setAllowedAreas(Qt::LeftDockWidgetArea|Qt::RightDockWidgetArea);QTextEdit *textEdit1=new QTextEdit();textEdit1->setText(tr("这是第一个 dockWidget，只能放在左部、右部，用户可以拖动位置"));dock1->setWidget(textEdit1);addDockWidget(Qt::RightDockWidgetArea,dock1);//默认在窗口的右部dock2 = new QDockWidget(tr("dock2"),this);dock2->setFeatures(QDockWidget::DockWidgetFloatable|QDockWidget::DockWidgetClosable);QTextEdit *textEdit2=new QTextEdit();textEdit2->setText(tr("这是第二个 dockWidget 只能放在下部、右部，用户可以将它拖出窗口，浮动在桌面上；也可以关闭它"));dock2->setWidget(textEdit2);addDockWidget(Qt::RightDockWidgetArea,dock2);
}

6.1 setFeatures()

上面的例子我们创建了两个 QDockWidget ，都通过 setFeatures() 设置了一些特性：dock1 可以移动；dock2 可浮动和可关闭。

可移动就是指用户可以将 dockWidget 从原本的右部拖到左部、下部等，至于可以拖动哪个部位则由 setAllowedAreas() 来控制。

上图是将 dock1 移动到了窗口的左部。

上图是将 dock2 拖出了主窗口，让 dock2 悬浮在桌面上。因为我们给 dock2 设置了：

dock2->setFeatures(QDockWidget::DockWidgetFloatable|QDockWidget::DockWidgetClosable);

点击右上角的关闭按钮即可关闭 dock2 ，而 dock1 没有设置可关闭特性，则不能关闭。

到这里，QMainWindow 中的各个部件就简单的介绍完了，对于每个部件更加详细的介绍就在后面的文章介绍了。比如让部件的 UI 元素更加丰富，功能更强大。

7 保存 / 设置窗口状态

很多时候，用户在关闭软件后，会记录一下程序当前的状态，用户下次打开软件后，还是上一次退出时的状态。比如：wps 的最近打开的文件记录；对软件界面的大小设置、常用快捷键的设置等。

下面两个方法可以保存窗口信息：

QByteArray saveGeometry() const;//保存窗口大小
QByteArray saveState(int version = 0) const;//保存当前状态，QToolBar 和 QDockWidget，version 可以自己设置版本号

相反的方法就是设置状态了：

bool restoreGeometry(const QByteArray &geometry);
bool restoreState(const QByteArray &state, int version = 0);

7.1 简单示例：

我们拿前面的例子做一个简单示例，启动程序后，我们调整窗口的大小，并将 dock2 拖出窗口，然后关闭窗口，再次启动程序，将会是我们上一次关闭时的状态。

//点击窗口的关闭按钮时执行
void MainWindow::closeEvent(QCloseEvent *event){QSettings settings("com.llk", "mainwindowtest");settings.beginGroup("mainWindow");settings.setValue("geometry", saveGeometry());settings.setValue("windowState", saveState());settings.endGroup();QMainWindow::closeEvent(event);
}
void MainWindow::readSettings(){QSettings settings("com.llk", "mainwindowtest");settings.beginGroup("mainWindow");//读取出保存的值，并设置到窗口中restoreGeometry(settings.value("geometry").toByteArray());restoreState(settings.value("windowState").toByteArray());settings.endGroup();
}

启动程序后，我们调整窗口的大小，再将 dock2 拖出窗口：

然后关闭软件，再启动我们的程序，还将展示上图的界面，说明程序记录了我们前一次关闭时的状态。

【注意】readSettings(); 方法的调用应在各个部件创建完成后再调用，否则没有效果。

这里我们是使用了 QSettings 类来帮我们存储窗口状态，其实我们也可以将数据保存到自己想保存的任意文件中，或是通过网络传给服务器保存都可以。只要将 saveGeometry() 和 saveState() 方法返回的字节数组的值保存起来，再次启动程序的时候再设置给 restoreGeometry() 和 restoreState() 即可。

8 完整代码

mainwindow.h：

#ifndef MAINWINDOW_H
#define MAINWINDOW_H#include <QMainWindow>
#include "qaction.h"
#include "qmenu.h"
#include "qmenubar.h"
#include "qstatusbar.h"
#include "qtoolbar.h"
#include "QDockWidget"
#include "qtextedit.h"
#include "QCloseEvent"
#include "qsettings.h"
#include "qdebug.h"class MainWindow : public QMainWindow
{Q_OBJECTprivate slots:void newActTriggered();void operateActTriggered();public:QMenuBar *mBar;//菜单栏QMenu *fileMenu;QMenu *editMenu;QAction *newAct;QAction *operateAct;QStatusBar *sBar;//状态栏QToolBar *fileToolBar;//文件工具栏QToolBar *ediToolBar;//文件工具栏QTextEdit *centerTextEdit;QDockWidget *dock1;QDockWidget *dock2;MainWindow(QWidget *parent = 0);void showMenus();void showStatusBar();void showToolBar();void showCentralWidget();void showDockWidget();void closeEvent(QCloseEvent *event);void readSettings();~MainWindow();
};

mainwindow.cpp：

#include "mainwindow.h"
//1、菜单栏
void MainWindow::showMenus()
{mBar = menuBar();fileMenu = mBar->addMenu(tr("文件"));editMenu = mBar->addMenu(tr("编辑"));operateAct = mBar->addAction(tr("操作"),this,SLOT(operateActTriggered()));newAct = new QAction("new");fileMenu->addAction(newAct);connect(this->newAct,SIGNAL(triggered()),this,SLOT(newActTriggered()));
}//2、状态栏
void MainWindow::showStatusBar(){sBar = statusBar();sBar->showMessage(tr("这里是状态栏"),0);
}
//3、工具栏
void MainWindow::showToolBar(){fileToolBar = addToolBar(tr("文件工具"));fileToolBar->setObjectName("fileToolBar");fileToolBar->setMovable(false);fileToolBar->addAction(newAct);ediToolBar = new QToolBar(tr("操作工具"));ediToolBar->setObjectName("ediToolBar");ediToolBar->addAction(operateAct);ediToolBar->addAction(newAct);ediToolBar->setMovable(false);addToolBar(ediToolBar);
}//4、中心区域
void MainWindow::showCentralWidget(){centerTextEdit=new QTextEdit(this);centerTextEdit->setText(tr("这里是中心区域"));centerTextEdit->setAlignment(Qt::AlignCenter);setCentralWidget(centerTextEdit);
}//5、悬浮部件
void MainWindow::showDockWidget(){dock1 = new QDockWidget(tr("dock1"),this);dock1->setObjectName("dock1");dock1->setFeatures(QDockWidget::DockWidgetMovable);dock1->setAllowedAreas(Qt::LeftDockWidgetArea|Qt::RightDockWidgetArea);QTextEdit *textEdit1=new QTextEdit();textEdit1->setText(tr("这是第一个 dockWidget，只能放在左部、右部，用户可以拖动位置"));dock1->setWidget(textEdit1);addDockWidget(Qt::RightDockWidgetArea,dock1);//默认在窗口的右部dock2 = new QDockWidget(tr("dock2"),this);dock2->setObjectName("dock2");dock2->setFeatures(QDockWidget::DockWidgetFloatable|QDockWidget::DockWidgetClosable);dock2->setAllowedAreas(Qt::BottomDockWidgetArea|Qt::RightDockWidgetArea);QTextEdit *textEdit2=new QTextEdit();textEdit2->setText(tr("这是第二个 dockWidget 只能放在下部、右部，用户可以将它拖出窗口，浮动在桌面上；也可以关闭它"));dock2->setWidget(textEdit2);addDockWidget(Qt::RightDockWidgetArea,dock2);
}void MainWindow::closeEvent(QCloseEvent *event){QSettings settings("com.llk", "mainwindowtest");settings.beginGroup("mainWindow");settings.setValue("geometry", saveGeometry());settings.setValue("windowState", saveState());settings.endGroup();QMainWindow::closeEvent(event);
}void MainWindow::readSettings(){QSettings settings("com.llk", "mainwindowtest");settings.beginGroup("mainWindow");restoreGeometry(settings.value("geometry").toByteArray());restoreState(settings.value("windowState").toByteArray());settings.endGroup();
}void MainWindow::newActTriggered(){qDebug()<<"newActTriggered()";
}void MainWindow::operateActTriggered(){qDebug()<<"operateTriggered()";
}MainWindow::MainWindow(QWidget *parent): QMainWindow(parent)
{showMenus();showStatusBar();showToolBar();showCentralWidget();showDockWidget();readSettings();
}MainWindow::~MainWindow()
{}

main.cpp：

#include "mainwindow.h"
#include <QApplication>int main(int argc, char *argv[])
{QApplication a(argc, argv);MainWindow w;w.show();return a.exec();
}