如何在QtDesigner5中将QMainWindow嵌入QTabWidget等部件？

核心思路纠正 #

QMainWindow是顶级窗口类，设计初衷是作为独立窗口使用，自带中央部件、菜单栏、状态栏等固定布局结构，直接嵌入QTabWidget会引发布局冲突和层级异常。正确方案是改用QWidget作为ThreadView的基类，在其中构建包含Dock Widget的布局，以此实现可嵌入的线程状态承载容器。

具体操作步骤（Qt Designer5） #

1. 创建基于QWidget的自定义部件 #

• 打开Qt Designer，新建Widget（而非MainWindow），作为ThreadView的基础容器。
• 右键点击Widget，选择Promote to...，将其提升为自定义的ThreadView类（后续在代码中实现该类的业务逻辑）。

2. 在Widget中添加Dock Widget容器 #

• 从左侧部件栏拖拽QDockWidget到当前Widget中。
• 配置QDockWidget：
  • 修改windowTitle为对应线程的标识（如"线程1状态"）。
  • 双击QDockWidget的内部区域，进入其嵌套Widget，添加展示控件：比如用QTextEdit显示汇编代码，用QTableWidget或QLabel展示线程状态参数。
  • 可添加多个QDockWidget，通过鼠标拖动调整停靠位置（左、右、上、下或浮动）。

3. 配置Widget的主布局 #

• 右键点击Widget，选择布局 -> 选择QVBoxLayout或QHBoxLayout，确保Dock Widget能自动适配容器大小。

4. 在主窗口中嵌入到QTabWidget #

• 回到主窗口设计界面，拖入QTabWidget。
• 点击QTabWidget的+按钮添加新标签页，右键标签页选择Promote to...，将其提升为刚才创建的ThreadView类；或直接将设计好的Widget拖入标签页区域。

代码层面兼容方案（可选） #

若需保留原ThreadView继承QMainWindow的逻辑，可通过代码提取其中央部件嵌入QTabWidget（会丢失原MainWindow的菜单栏、状态栏等顶层特性）：

// 实例化原ThreadView
ThreadView *threadView = new ThreadView();
// 提取中央部件并解除与原窗口的关联
QWidget *embeddedWidget = threadView->centralWidget();
embeddedWidget->setParent(nullptr);
// 添加到QTabWidget
ui->tabWidget->addTab(embeddedWidget, "线程1");

关键注意点 #

• 禁止将QMainWindow作为子部件嵌入，这违反Qt窗口层级设计规范，易导致布局错乱、事件传递异常。
• 自定义ThreadView类时，若基于QWidget，需在构造函数中同步初始化布局和Dock Widget的逻辑，确保与Designer中的设计匹配。

内容的提问来源于stack exchange，提问作者余政倫