关于QT纯代码创建UI的方法和注意事项

前言

温故而知新。之前新学QT时没怎么注意纯代码创建UI的写法，今天尝试着写了一下，却发现就一个简单的布局，总是显示不出来。所以索性研究了一下#include "ui_mainwindowtest.h"QTCreator自动编译生成的代码，将一些个人收获总结如下。

---

一、QT的UI头文件里有什么？

之前一直没注意，仅是创建了一个空白窗口，它的ui头文件里就出现了这么多代码。现将个人见解以备注地形式写在上面。

#ifndef UI_MAINWINDOWTEST_H
#define UI_MAINWINDOWTEST_H

#include <QtCore/QVariant>
#include <QtWidgets/QApplication>
#include <QtWidgets/QMainWindow>
#include <QtWidgets/QMenuBar>
#include <QtWidgets/QStatusBar>
#include <QtWidgets/QWidget>

QT_BEGIN_NAMESPACE

class Ui_MainWindowTest
{
public:
	//创建QMainWindow的centralwidget，下面的所有部件其实都是以此为起始点，一步一步往下创建。
    QWidget *centralwidget;
    //QMenuBar和QStatusBar，是QMainWindow都会有的
    QMenuBar *menubar;
    QStatusBar *statusbar;

	//一般在MainWindowTest的构造函数中都会通过“ui->setupUi(this);”调用这个初始化函数，this指针就传给了MainWindowTest
    void setupUi(QMainWindow *MainWindowTest)
    {
        if (MainWindowTest->objectName().isEmpty())
            MainWindowTest->setObjectName(QString::fromUtf8("MainWindowTest"));
        MainWindowTest->resize(456, 316);
        //正片开始了，从MainWindowTest出发先创建一个centralwidget
        centralwidget = new QWidget(MainWindowTest);
        centralwidget->setObjectName(QString::fromUtf8("centralwidget"));
        //此为关键步骤，必须要让MainWindowTest执行setCentralWidget，不然添加的其他控件，虽然与centralwidget建立了关联，但都无法与MainWindowTest建立关联
        MainWindowTest->setCentralWidget(centralwidget);
        //底下就是QMenuBar和QStatusBar的初始化操作，不赘述
        menubar = new QMenuBar(MainWindowTest);
        menubar->setObjectName(QString::fromUtf8("menubar"));
        menubar->setGeometry(QRect(0, 0, 456, 17));
        MainWindowTest->setMenuBar(menubar);
        statusbar = new QStatusBar(MainWindowTest);
        statusbar->setObjectName(QString::fromUtf8("statusbar"));
        MainWindowTest->setStatusBar(statusbar);

        retranslateUi(MainWindowTest);

        QMetaObject::connectSlotsByName(MainWindowTest);
    } // setupUi

    void retranslateUi(QMainWindow *MainWindowTest)
    {
        MainWindowTest->setWindowTitle(QCoreApplication::translate("MainWindowTest", "MainWindow", nullptr));
    } // retranslateUi

};

namespace Ui {
	//个人感觉这句代码相当于是将Ui_MainWindowTest重名为了MainWindowTest。因为出了这个文件Ui_MainWindowTest都叫MainWindowTest
    class MainWindowTest: public Ui_MainWindowTest {};
} // namespace Ui

QT_END_NAMESPACE

#endif // UI_MAINWINDOWTEST_H

二、自己尝试写写

代码大同小异，就以最简单的添加按钮为例，记录一下

1.先贴上最官方的写法

其一（此写法容易理解）

MainWindowTest::MainWindowTest(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindowTest)
{
    ui->setupUi(this);
    //仿照之前的程序，先创建一个“起始点”QWidget。
    QWidget *qWidget = new QWidget(this);
    //接下新创建的按钮和布局都认他当“爹”
    QPushButton *qPushButton = new QPushButton(qWidget);
    QVBoxLayout *qVBoxLayout = new QVBoxLayout(qWidget);
    //将按钮添加到布局中，这样qPushButton就从属于qVBoxLayout了
    qVBoxLayout->addWidget(qPushButton);
    //最后一步，“认祖宗”，不然都白瞎
    this->setCentralWidget(qWidget);
}

其二（此写法方便一点）

直接利用QT自动创建的centralwidget指针

MainWindowTest::MainWindowTest(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindowTest)
{
    ui->setupUi(this);
    //直接新建按钮和布局
    QPushButton *qPushButton = new QPushButton(this);
    QVBoxLayout *qVBoxLayout = new QVBoxLayout(this);
    //将按钮添加到布局中，这样qPushButton就从属于qVBoxLayout了
    qVBoxLayout->addWidget(qPushButton);
    //最后一步，认“爹”。
    //注意，这里的centralwidget是qt自动创建的，不是自己创建的，可在上文的ui_mainwindowtest.h头文件中找到
    ui->centralwidget->setLayout(qVBoxLayout);
}

2.再贴几个人感觉都可以的写法

其一

MainWindowTest::MainWindowTest(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindowTest)
{
    ui->setupUi(this);
    //仿照之前的程序，先创建一个“起始点”QWidget。
    QWidget *qWidget = new QWidget(this);
    //先认“祖宗”，后面再划分
    QPushButton *qPushButton = new QPushButton(this);
    QVBoxLayout *qVBoxLayout = new QVBoxLayout(this);
    //将按钮添加到布局中，这样qPushButton就从属于qVBoxLayout了
    qVBoxLayout->addWidget(qPushButton);
    //先认“祖宗”的话，最后在这里就要再认一下“爹”
    qWidget->setLayout(qVBoxLayout);
    //最后一步，“认祖宗”
    this->setCentralWidget(qWidget);
}

其二

MainWindowTest::MainWindowTest(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindowTest)
{
    ui->setupUi(this);
    //仿照之前的程序，先创建一个“起始点”QWidget。
    QWidget *qWidget = new QWidget(this);
    //先放养
    QPushButton *qPushButton = new QPushButton();
    QVBoxLayout *qVBoxLayout = new QVBoxLayout();
    //将按钮添加到布局中，这样qPushButton就从属于qVBoxLayout了
    qVBoxLayout->addWidget(qPushButton);
    //最后一步认“爹”，因为qPushButton已经从属于qVBoxLayout了，所以只要setLayout就行了
    qWidget->setLayout(qVBoxLayout);
    //最后一步，“认祖宗”。其实第一步括号里也可以不写this。这样QWidget *qWidget = new QWidget();也是OK的
    this->setCentralWidget(qWidget);
}

3.错误写法

虽然表面上看上去有从属关系，但是没有setCentralWidget是万万不行的，切记。一开始我就是这么写的，结果窗口上就只有一个按钮，没有布局。

MainWindowTest::MainWindowTest(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindowTest)
{
    ui->setupUi(this);
    QPushButton *qPushButton = new QPushButton(this);
    QVBoxLayout *qVBoxLayout = new QVBoxLayout(this);
    qVBoxLayout->addWidget(qPushButton);
    this->setLayout(qVBoxLayout);
}

三、可参考的更为详细的创建步骤

可参考博客: http://c.biancheng.net/view/1824.html