如何正确添加.h文件至项目？Qt窗体切换代码报错求助

1. 如何正确将.h文件添加到项目中？ #

针对CMake项目（你当前使用的环境）： #

• 确保头文件与源码文件处于同一目录，或放在指定的头文件目录下。
• 如果头文件不在默认搜索路径，需在CMakeLists.txt中用target_include_directories指定路径，例如：

  target_include_directories(YourAppName PRIVATE ${PROJECT_SOURCE_DIR}/include)
  

• 对于Qt自动生成的头文件（如ui_history.h），无需手动添加，只要在qt_add_executable中包含对应的.ui文件，CMake会自动处理生成与引用路径配置。
• 代码中用#include "xxx.h"引用头文件，路径匹配即可（同一目录直接写文件名，子目录需补全相对路径）。

2. Qt项目：窗体替换需求与报错解决 #

先解决history.cpp的报错问题 #

常见报错原因及解决方法：

1. ui_history.h找不到
   • 检查CMakeLists.txt的qt_add_executable是否包含了history.ui文件，正确配置示例：

     qt_add_executable(YourAppName
         main.cpp
         mainwindow.cpp mainwindow.hpp mainwindow.ui
         history.cpp history.hpp history.ui
     )
     

   • 确认已链接Qt Widgets模块：

     target_link_libraries(YourAppName PRIVATE Qt6::Widgets)
     

   • 点击Qt Creator顶部的「Run CMake」按钮重新生成构建配置，确保ui_history.h在构建目录的ui子文件夹中生成。
2. 类定义不匹配
   • 检查history.hpp中Ui::History的前向声明是否与.ui文件的类名一致（.ui文件的对象名需为History）。

实现「替换原窗体打开新页面」的需求 #

你的History类当前继承QDialog，这是对话框类，不符合「替换主窗体内容」的需求，需调整为以下方案：

步骤1：修改History类基类

将history.hpp中的基类从QDialog改为QWidget：

#ifndef HISTORY_HPP
#define HISTORY_HPP

#include <QWidget> // 替换<QDialog>

namespace Ui {
class History;
}

class History : public QWidget // 替换QDialog
{
    Q_OBJECT

public:
    explicit History(QWidget *parent = nullptr);
    ~History();

private:
    Ui::History *ui;
};

#endif // HISTORY_HPP

步骤2：在主窗口中实现页面切换

推荐使用QStackedWidget来管理多个页面（更灵活，支持切换回原页面）：

1. 在mainwindow.ui中，将默认的centralWidget替换为QStackedWidget（或在代码中创建）。
2. 修改mainwindow.hpp，添加History对象的声明（替换原History *historyDialog）：

   private:
       Ui::MainWindow *ui;
       History *historyPage; // 改为historyPage，明确是页面而非对话框
   

3. 在MainWindow构造函数中初始化页面：

   MainWindow::MainWindow(QWidget *parent)
       : QMainWindow(parent)
       , ui(new Ui::MainWindow)
   {
       ui->setupUi(this);
       // 假设ui->stackedWidget是你添加的QStackedWidget
       // 创建并添加History页面
       historyPage = new History(this);
       ui->stackedWidget->addWidget(historyPage);
   }
   

4. 实现按钮点击的槽函数，切换到History页面：

   void MainWindow::on_pushButton_3_clicked()
   {
       ui->stackedWidget->setCurrentWidget(historyPage);
   }
   

如果不需要保留原页面，也可以直接替换centralWidget：

void MainWindow::on_pushButton_3_clicked()
{
    QWidget *oldWidget = centralWidget();
    History *newPage = new History(this);
    setCentralWidget(newPage);
    oldWidget->deleteLater(); // 延迟删除，避免立即销毁导致的界面异常
}

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