如何为现有Qt项目添加自定义QDialog对话框？

1. Qt Creator中直接生成（最稳妥的方式） #

• 右键项目目录，选添加新文件
• 在弹窗里选Qt分类下的Qt Designer Form Class，点击选择
• 下一步在Form template里挑适合的对话框模板：比如Dialog without Buttons或者带按钮的模板，按需选择
• 填写类名StepsDialog，确认头文件、源文件、UI文件的路径正确，点下一步完成创建
  • 这一步Qt会自动帮你生成配套的.h、.cpp、.ui文件，还会配置项目构建，自动生成ui_StepsDialog.h，完全不用手动折腾

2. 关联已写好的StepsDialog类 #

如果你已经手动写完了StepsDialog的.h和.cpp，可以这么绑定新的QDialog.ui文件：

• 先按上面的步骤临时创建一个QDialog类（比如叫TempDialog），拿到生成的.ui文件后，重命名为StepsDialog.ui放到项目目录
• 用文本编辑器打开这个.ui文件，确保根节点是：

  <ui version="4.0">
      <class>StepsDialog</class>
      <widget class="QDialog" name="StepsDialog">
  

  如果是复制的主窗口UI，必须把<widget class="QMainWindow"改成<widget class="QDialog"，还要删掉主窗口特有的节点（比如centralwidget、menubar、statusbar这些）
• 在项目的.pro文件里加一行FORMS += StepsDialog.ui，让Qt构建系统识别这个UI文件
• 修改你的StepsDialog.h，添加UI对象声明：

  #include <QDialog>
  #include "ui_StepsDialog.h"
  
  class StepsDialog : public QDialog
  {
      Q_OBJECT
  
  public:
      explicit StepsDialog(QWidget *parent = nullptr);
      ~StepsDialog();
  
  private:
      Ui::StepsDialog *ui;
  };
  

• 修改StepsDialog.cpp初始化UI：

  #include "StepsDialog.h"
  
  StepsDialog::StepsDialog(QWidget *parent) :
      QDialog(parent),
      ui(new Ui::StepsDialog)
  {
      ui->setupUi(this);
  }
  
  StepsDialog::~StepsDialog()
  {
      delete ui;
  }
  

3. 关于手动修改现有UI文件的问题 #

不推荐直接复制主窗口UI改，因为主窗口有很多专属组件和结构，手动删容易漏东西，导致Qt Designer加载出错。如果非要改，必须做到：

• 文本编辑器打开复制的UI，把根widget的class属性从QMainWindow改成QDialog
• 删除所有QMainWindow专属子元素：centralwidget、menubar、statusbar这些节点
• 把<class>标签里的名称改成StepsDialog，和你的类名一致
• 保存后用Qt Designer打开检查，确认能正常加载再用

4. 主窗口中调用自定义对话框 #

在主窗口UI加好按钮后，绑定点击事件：

// 主窗口.cpp文件中
#include "StepsDialog.h"

// 假设按钮名为pushButton_openDialog
void MainWindow::on_pushButton_openDialog_clicked()
{
    StepsDialog dialog(this);
    dialog.exec(); // 模态对话框，阻塞主窗口操作
    // 非模态用 dialog.show(); 注意要管理好内存，比如用new+parent或者智能指针
}

内容的提问来源于stack exchange，提问作者Tyler Shellberg