Qt布局中同参数QTableView拉伸窗口不同步的原因与解决方法

• Qt 布局系统在分配窗口拉伸产生的剩余横向空间时，会严格按照控件的尺寸约束、sizePolicy、所在布局的拉伸系数三个维度计算每个控件的最终宽度。出现单个QTableView拉伸幅度远大于其他同步控件的情况，核心是三类规则匹配不一致：
  • 尺寸约束的计算时序偏差：代码中实时取verticalHeader()宽度、指定列宽度计算目标表格宽度的逻辑，执行时机早于控件完成首次布局初始化，导致计算出的tableWidth值不稳定，给最后一个QTableView设置的MaximumWidth实际值远大于其他控件的约束值
  • 布局拉伸因子不匹配：最后一个QTableView所在的嵌套布局/网格列，设置了非0的水平拉伸系数，而其他几个QTableView所在的列拉伸系数为0，窗口拉伸产生的剩余空间会被全部分配给这个带拉伸系数的列，连带同列绑定的QPushButton、标签控件一起偏移
  • 尺寸约束的传递断层：虽然所有QTableView都单独设置了MaximumWidth，但最后一个QTableView的父容器没有被对应的宽度规则约束，相当于父布局没有继承上层的宽度限制，会按照自身的sizePolicy独立拉伸，突破控件本身的最大宽度约束

• 调整尺寸计算的执行时机：将设置表格最大宽度的逻辑，从构造函数中移到控件首次完成布局渲染的节点（比如窗口的showEvent回调、或监听布局完成的信号），等所有表格的垂直头宽度、指定列宽度完成首次初始化后，再统一计算tableWidth值，给所有表格同步设置最大宽度
• 统一所有QTableView的水平方向尺寸策略：将所有表格的水平sizePolicy设置为不会主动抢占剩余空间的策略，避免表格自身的Expanding属性带来的非预期拉伸，统一配置代码示例：

  // 统一遍历所有表格控件设置尺寸规则
  const auto allTables = {
      ui->tableErr_Right, ui->tableErr_left,
      ui->tableCSB_Right, ui->tableCSB_Left,
      ui->tableLeft_Coupling, ui->tableRight_Coupling
  };
  // 等控件完成首次布局后再执行配置
  int hHeaderWidth = ui->tableCSB_Right->verticalHeader()->width();
  int rowWidth = ui->tableErr_Right->columnWidth(0);
  int tableWidth = (nbOfAnt / 2) * rowWidth + hHeaderWidth;
  for (auto table : allTables) {
      table->setMaximumWidth(tableWidth);
      table->setSizePolicy(QSizePolicy::Fixed, QSizePolicy::Expanding);
  }
  

• 统一布局的拉伸系数规则：检查所有放置QTableView的网格布局、嵌套水平/垂直布局，把所有摆放表格的列拉伸系数统一设为0，禁止布局将窗口拉伸产生的剩余空间分配给这些列；如果存在嵌套布局，要确保从表格本身到最外层主窗口的所有父容器，都没有设置非0的水平拉伸系数
• 规避表格自身的宽度自适应偏差：将每个QTableView的水平表头列宽模式设置为固定，禁止窗口拉伸时表格内部自动调整列宽，从根源上消除宽度计算的误差

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