如何防止QLabel因内部文本自动扩张超出布局边界？

QLabel默认水平尺寸策略为QSizePolicy::Preferred，该策略下控件尺寸请求不会受父布局可用空间约束，当文本长度超过布局分配宽度时，会持续向上传递扩张请求，最终撑破内部承载容器、突破QScrollArea视口边界。之前测试中可近似实现效果的配置，大概率是开启了QScrollArea::widgetResizable属性，但未同步配置内部控件的尺寸约束，会导致滚动区无法随内容高度自适应。

以下两种方案可按需选择，均能实现预期布局效果：

方案1：从控件层约束QLabel，长文本自动截断 #

该方案不需要调整滚动区配置，逻辑耦合度最低：

• 所有展示可变长文本的QLabel（姓名、描述、邮箱字段）统一设置尺寸策略：

  // 水平方向完全服从布局分配宽度，垂直方向按内容高度适配
  label->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Preferred);
  

• 关闭QLabel基于文本长度的最小宽度限制，开启文本截断：

  // 超出宽度的文本末尾显示省略号，无需省略号可替换为Qt::ElideNone直接硬截断
  label->setTextElideMode(Qt::ElideRight);
  // 取消QLabel默认根据文本计算最小宽度的逻辑，从根源阻止控件主动扩张
  label->setMinimumWidth(0);
  

• 联系人条目、内部承载QWidget的布局不要设置SetFixedSize类的硬约束，保留水平方向拉伸能力。

方案2：从滚动区层锁死边界，禁止内部组件撑大视口 #

该方案不需要逐个修改QLabel配置，适合动态生成控件较多的场景：

• 正确配置QScrollArea核心属性，不要直接关闭自适应能力：

  // 让内部承载容器默认适配滚动区视口宽度，仅高度随内容变化
  scrollArea->setWidgetResizable(true);
  // 关闭水平滚动条，禁止水平方向滚动
  scrollArea->setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
  

• 绑定滚动区尺寸变化事件，强制内部承载容器宽度不超过视口宽度：

  // 初始化时先设置一次宽度上限
  contentWidget->setMaximumWidth(scrollArea->viewport()->width());
  // 窗口拉伸、滚动区尺寸变化时同步更新宽度上限，阻断内部控件的扩张请求
  connect(scrollArea, &QScrollArea::resized, this, [=](){
      contentWidget->setMaximumWidth(scrollArea->viewport()->width());
  });
  

• 不要给QLabel设置水平方向QSizePolicy::Ignored策略，会导致拉伸时控件宽度比例完全失控
• 不要给内部承载QWidget设置固定宽度，否则窗口拉伸时联系人条目无法同步放大
• 若需要查看长文本完整内容，可给对应QLabel设置setToolTip(label->text())，鼠标悬浮时即可展示全量内容，不需要破坏布局结构

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