【快速上手QT】01-QWidgetQMainWindow QT中的窗口

总所周知，QT是一个跨平台的C++图形用户界面应用程序开发框架。它既可以开发GUI程序，也可用于开发非GUI程序，当然我们用到QT就是要做GUI的，所以我们快速上手QT的第一篇博文就讲QT的界面窗口。

我用的IDE是VS2019，使用QTcreator的小伙伴也是可以跟着一起学习的，毕竟QT提供的API都是一样的，就是配置方面会有些许不同。

窗口的选择

我们创建一个QT项目，会让我们选择一个作为我们界面的基类，是从这三个里选：QWidget，QMainWindow，QDialog。默认是给我们选QMainWindow。

QWidget是精简版的窗口，也就是单单一个窗口其他啥也没有。

QMainWindow与QWidget相比，就是可以带菜单栏的QWidget。

QDialog比较不一样，它属于对话框，一般来说主界面不会选择它作为基类去继承它。

QMainWindow和QDialog都是QWidget的子类，也就是说QWidget是一切窗口类的爹。

下面是基于QMainWindow的界面。

下面是基于QWidget的界面。

下面是基于QDialog的界面。

可以看的出来QWidget就是一个普普通通的界面，而QMainWindow对比QWidget就多了一个工具栏（不是菜单栏）。但是当我把初始化安排上的UI（ui.setupUi(this)）删掉之后QMainWindow连那个工具栏也没有了，跟QWidget也没有什么区别。

QDialog的右上角与另外两个不一样，上面两个是常规的最小化，放大，退出。而QDialog变成了一个问号和退出。

一般情况下我们都是选择QWidget和QMainWindow比较多。对我来说，我不喜欢使用QtDesigner也就是图形化UI设计，因此在我这里QWidget和QMainWindow都是一样的，我就是用的默认选择。

QWidget

当我把QtDesigner配置的ui删掉之后可以看到界面变成下面这样了。

因为没有了界面大小的设置，整个窗口挤成一团了。

既然我不使用QtDesigner来布局界面，那么我就需要使用代码来对窗口进行设置了。

学习QT的最好办法就是去查阅QT官方提供的手册，就是在我们安装QT的目录下面就有自带的手册。找不到的小伙伴使劲去找，实在找不到的话还有网页的中文版。

Qt 5.9.9 -中文文档编制,帮助,手册,教程Qt5 / C/C++ / GUI 框架 / 中文文档编制 / 中文帮助 / 中文手册 / 中文教程http://qt5.digitser.top/5.9/zh-CN/index.htmlQMainWindow的函数有很多，下面的图都还没截完。我们只挑几个常用的（我个人认为的）来讲讲，因为我们是快速上手嘛。

第一件事，设置大小

但是我们在QMainWindow拥有的函数中好像并没有找到相关的函数，因此我们需要往它的父类找，也就是QWidget里。因为接下来介绍的函数是属于QWidget的，但是三个窗口基类都可以使用，属于通用的函数。

很快我们就能找到很多相关函数。

void resize(int w, int h)

这个函数就可以修改窗口的大小，当然它还有重载函数，不过我们就先不提。

我们发现我们设置完大小之后仍然可以通过拖拽的方式去修改窗口的大小，我们也可以设置为固定的大小不允许手动修改窗口大小。

void setFixedSize(int w, int h)

除了设定固定的大小，我们还可以单独设置固定长度或是高度，这样子除了固定死的一边之外，剩下一边的大小还是可以通过拖拽来改变。

void setFixedHeight(int h)
void setFixedWidth(int w)

当然，除了通过固定的方法不让用户拖拽，我们还可以用别的办法去限制窗口的大小。

void setMaximumHeight(int maxh)
void setMaximumSize(int maxw, int maxh)
void setMaximumWidth(int maxw)
void setMinimumHeight(int minh)
void setMinimumSize(int minw, int minh)
void setMinimumWidth(int minw)

从上面函数的名字应该可以知道，这些函数可以去设置窗口的最大最小的长和宽，也就是可以把窗口的大小限制在一个范围里，用户可以拖拽窗口来修改大小，但是不能比我们设置的最小大小更小，也不能比我们设置的最大大小更大。

第二件事，起个名字

void setWindowTitle(const QString &)

使用上面的函数我们直接给一个字符串就可以修改窗口的名称了。

但是我们发现，我们的中文的乱码的，这是编码格式的问题，因此在QT中如果我们使用到了中文，那么都按照下面的格式去使用，不需要去记，我们直接用就行。

QString::fromLocal8Bit("折途");

这样就没问题了。

除了设置名字以外，我们还可以修改窗口左上角的小图标。

void setWindowIcon(const QIcon &icon)

这个函数我们需要传入一个QIcon类型的变量，我们先不管那么多，就按照我上面的写法，直接马上弄一个QIcon，传入的参数就是图片的路径。

当然我上面的写法不规范，一般在QT中我们使用图片资源之类的我们有其他方法，很少这样直接使用文件路径来写的，这个之后的文章中会说。

开启关闭

这时候我们常用的基础设置基本上就上面这些，我们再回过头看看main函数。

可以看得出来创建工程的时候，默认是帮我们把main函数写好了。

主要我们看看帮我们创建的我们主界面的类，它还帮我们调用了show这个函数。

当我们把使用show这行代码删掉之后我们能发现我们的界面不会像之前那样自己弹出来了，并且程序也没有退出，仍然在执行。

那么我们可以判断出show函数就是让我们的界面出现的。

void show()

而有显示也就有退出。

bool close()

我们在主函数中show函数的后面加上close函数，我们就能发现窗口弹出后很快就又消失了。实际上当主窗体使用了close之后应该是退出整个程序的，但是我们发现窗口消失之后程序并没有结束。这是因为我们写在了main函数里，在执行完close之后我们卡在了a.exec()中。只有我们已经卡在了a.exec()中的时候我们再调用close才会使得程序退出，这一点如何实现我们有很多办法，在后续的文章中会提到。

那如果我们想要页面消失但是又不想程序退出那该怎么办呢？

void hide()

调用上面的函数我们会将当前窗口隐藏，但是不会退出程序，而我们再次调用show时窗口又会出来。

QMainWindow

上面讲了一些通用的函数，那么接下来就讲一讲QMainWindow特有的函数了。

我们知道QMainWindow就是比QWidget多了个菜单栏，那么我们就先说说QMainWindow如何添加菜单栏。

QMenuBar菜单栏

凭借我高超的英语水平~~（四级差122分）~~，一眼就能找出如何给我们的QMainWindow添加一个菜单栏。

void setMenuBar(QMenuBar *menuBar)

但是要添加菜单栏，我们首先需要有菜单栏，需要传入的参数是QMenuBar类型的变量指针。

这时候我们可以在QT官方手册里再去搜索QMenuBar。

可以看出我们要构造一个QMenuBar出来，只需要传递一个QWidget*类型的参数即可，这个我们只需要填入this即可（需要在我们主界面的成员函数中创建才可以使用this）。

至于为什么就涉及到QT的机制了。简单来说就是给QMenuBar认个“义父”，构造函数的形参名字也叫parent嘛。参数填入this就可以认为我们把这个QMenuBar挂载在了我们的主界面上，当主界面被关闭之后（调用了析构函数），会自动释放“义子们”的资源，也就是说我们new了一个QMenuBar，但是我们不需要手动去释放资源，这也是QT方便的地方。

那么我们可以创建一个QMenuBar的对象，然后添加进我们的主界面里。

但是我们却发现界面里并没有菜单栏，这是不是我们代码写错了呢。

其实菜单栏已经有了，只是我们看不到而已，因为菜单栏是空的。

菜单栏自然是有菜单的，所以我们还需要给菜单栏添加菜单。

QMenu菜单

凭借我高超的英语水平~~（四级差122分）~~，一眼就能找出如何给我们的QMenuBar添加一个菜单。

QAction *addMenu(QMenu *menu)
QMenu *addMenu(const QString &title)
QMenu *addMenu(const QIcon &icon, const QString &title)

有三个重载版本，我们接下来把三种全试一遍。

第二个还好说，只要传入字符串即可，但是第一种的QMenu和第三种的QIcon又是什么鬼。

我们一个个看，人家要QMenu我们就创建一个QMenu嘛，反正我们有QT官方提供的手册，搜索一下就OK啦。

我们在QMenu的构造函数中就可以直接给出QMenu上面的文字，也可以后续通过调用它的成员函数去设置。那么获取QMenu的问题就算搞定了。

那么QIcon其实也是一样的。

它的构造函数比较多，我们就使用我们上面用过的，直接传入图片的路径就行。

那么接下来我们就为我们的菜单栏去添加菜单吧。

#include "ZheTu.h"


ZheTu::ZheTu(QWidget *parent): QMainWindow(parent){
    this->setFixedSize(1000,1000);
    this->setWindowTitle(QString::fromLocal8Bit("折途"));
    this->setWindowIcon(QIcon("./zhetu.ico"));

    QMenuBar* mb = new QMenuBar(this);
    this->setMenuBar(mb);

    mb->addMenu("one");

    QMenu* m2 = new QMenu("two", this);
    mb->addMenu(m2);

    mb->addMenu(QIcon("./zhetu.ico"), "three");

}

ZheTu::~ZheTu()
{}

这样我们就可以看到菜单栏了，并且菜单栏里也有了菜单。

但是我们注意到第三个菜单只能看到icon图标而看不到文字了，这个搞起来挺麻烦的，我查了好久也没有找到比较简单的方法，那么我们就尽量避免在菜单栏中添加带图片的菜单吧。

有了菜单之后菜单也空荡荡的，我们可以给菜单添加菜单项。

QAction菜单项

凭借我高超的英语水平~~（四级差122分）~~，一眼就能找出如何给我们的QMenu添加一个菜单项。

可以看出有八个重载版本，我们应该选哪一个呢，一般情况下我们都不选，我们选择它父亲（父类）的函数，也就是QWidget的函数，没错，QMenu也继承了QWidget。

为了使用上面这一种重载版本，我们需要创建一个QAction出来，我们照例是在Qt助手里搜索。

有三种构造函数，我们都来试一试。

#include "ZheTu.h"

ZheTu::ZheTu(QWidget *parent): QMainWindow(parent){
    this->setFixedSize(1000,1000);
    this->setWindowTitle(QString::fromLocal8Bit("折途"));
    this->setWindowIcon(QIcon("./zhetu.ico"));

    QMenuBar* mb = new QMenuBar(this);
    this->setMenuBar(mb);

    QMenu* m1 = new QMenu("one", mb);
    mb->addMenu(m1);
    
    QMenu* m2 = new QMenu("two", mb);
    mb->addMenu(m2);
    
    QAction* a1 = new QAction(m2);
    QAction* a2 = new QAction("a2", m2);
    QAction* a3 = new QAction(QIcon("./zhetu.ico"), "a3", m2);
    m2->addAction(a1);
    m2->addAction(a2);
    m2->addAction(a3);
}

可以看得出我们确实是添加了三个菜单项出来了，第一个没有指定文本，因此是空白的，前两个没有指定icon，因此在图标的位置上是空着的。

我是用的VS2019敲的QT，人家VS的菜单栏中的菜单项里还有选项就像下图一样，这个是怎么做的呢。

实际上QMenu也可以添加QMenu，也就是说我们除了给 QMenu添加QAction以外，添加QMenu也是可以套娃的。

#include "ZheTu.h"

ZheTu::ZheTu(QWidget *parent): QMainWindow(parent){
    this->setFixedSize(1000,1000);
    this->setWindowTitle(QString::fromLocal8Bit("折途"));
    this->setWindowIcon(QIcon("./zhetu.ico"));

    QMenuBar* mb = new QMenuBar(this);
    this->setMenuBar(mb);

    QMenu* m1 = new QMenu("one", mb);
    mb->addMenu(m1);
    
    QMenu* m2 = new QMenu("two", mb);
    //mb->addMenu(m2);
    m1->addMenu(m2);
    

    QAction* a1 = new QAction(m2);
    QAction* a2 = new QAction("a2", m2);
    QAction* a3 = new QAction(QIcon("./zhetu.ico"), "a3", m2);
    m2->addAction(a1);
    m2->addAction(a2);
    m2->addAction(a3);
}

其他部件

在我们QMainWindow中，我们可以拥有一个菜单栏，一个状态栏，一个中心部件，多个工具栏和多个铆接部件。

添加的函数分别是

void setMenuBar(QMenuBar *menuBar);
void setStatusBar(QStatusBar *statusbar);
void setCentralWidget(QWidget *widget);
void addToolBar(QToolBar *toolbar);
void addDockWidget(Qt::DockWidgetArea area, QDockWidget *dockwidget);

其实从名字我们也可以看的出来哪些是只能有一个的，哪些是可以有多个的。只能有一个的部件那么函数开头是set，而可以有多个的部件函数开头是add。

中心部件就是指定一个其他部件作为中心，比如说我要自己写一个VS出来，那么敲代码的部分就是中心对吧，那么我就可以把敲代码存放文本的部件设置为中心部件，不过实际上我不设置也可以，只要布局的合理就行，所以这里不介绍添加中心部件。

铆接部件是整一个区域出来，我们可以拖动它放到其他地方，但实际上也没什么卵用所以也不介绍了，可以参考前阵子力扣更新的自定义界面功能。

工具栏可以有多个，这个用的比较多，但是很简单，就当它是可以有多个并且可以自己拖动到其他位置（不一定在顶上）的菜单栏就行，给工具栏也是添加QAction的，比菜单栏就多了个可以停靠在其他位置（左边，右边，下面。。。），所以很简单，这里也不介绍了。

QStatusBar状态栏

状态栏只能有一个，它的函数不多，就下面几个。

我们就记住两个就行。

void addPermanentWidget(QWidget *widget, int stretch = 0);
void addWidget(QWidget *widget, int stretch = 0);

我们的状态栏是在界面的最下面的，第一个函数会把添加的QWidget*类型的参数添加到状态栏的右侧，也就是界面的右下方。第二个函数会添加到左侧，也就是界面的左下方。

那么我们需要创建一个QWidget对象吗，它不是一个界面吗，怎么塞得进一个状态栏里。

这里有点超纲了，我们就记住对于状态栏，我们一般给它塞的参数是QLabel类型的，这是一个标签类，他的父类的父类是QWidget，所以我们实际上使用了多态。

具体的我以后的文章会讲，这里看看我下面的用法就行。

#include "ZheTu.h"

#include <QLabel> 

ZheTu::ZheTu(QWidget *parent): QMainWindow(parent){
    this->setFixedSize(1000,1000);
    this->setWindowTitle(QString::fromLocal8Bit("折途"));
    this->setWindowIcon(QIcon("./zhetu.ico"));

    QStatusBar* sb = new QStatusBar(this);
    this->setStatusBar(sb);

    QLabel* l1 = new QLabel("this is left", this);
    sb->addWidget(l1);
    QLabel* l2 = new QLabel("this is right", this);
    sb->addPermanentWidget(l2);

}