如何在QWidget C++中启用QLabel的字符换行（非单词换行）

要实现标签宽度足够时按单词换行，宽度不足单个单词时按字符拆分换行的效果，你可以通过自定义QLabel的QTextDocument换行策略来实现，具体步骤如下：

• 首先开启QLabel的自动换行功能：

  label->setWordWrap(true);
  

• 获取QLabel关联的QTextDocument，修改其默认文本选项的换行模式为QTextOption::WrapAtWordBoundaryOrAnywhere：

  QTextDocument* doc = label->document();
  QTextOption textOption = doc->defaultTextOption();
  // 优先按单词边界换行，单个单词超出宽度时自动按字符拆分
  textOption.setWrapMode(QTextOption::WrapAtWordBoundaryOrAnywhere);
  doc->setDefaultTextOption(textOption);
  

效果说明 #

• 当标签宽度充足时，"Hello World"会正常显示在同一行；
• 当宽度缩小到无法容纳整个短语但能放下单个单词时，"World"会自动换行到下一行；
• 当宽度继续缩小到连"Hello"这类单个单词都无法容纳时，单词会被按字符拆分换行（比如显示为He\nllo）；
• 当标签尺寸扩大时，文本会自动重新排版，恢复到符合宽度的正常显示状态，无需额外处理。

如果是在Qt Designer中创建的QLabel，你只需要在窗口类的构造函数或初始化方法中添加上述代码即可生效。

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