0

0

如何在 PySide6 中使用 QPainter 实现文本自动换行

碧海醫心

碧海醫心

发布时间:2026-01-12 10:16:05

|

186人浏览过

|

来源于php中文网

原创

如何在 PySide6 中使用 QPainter 实现文本自动换行

在 pyside6 中,`qpainter.drawtext()` 默认不支持自动换行;需正确组合 `qt.alignmentflag` 与 `qt.textflag.textwordwrap`(而非 `qtextoption.wrapmode`)才能使长文本在指定矩形内按词换行并居中对齐。

要在 QPainter 绘图过程中实现文本在矩形区域内的自动换行(Word Wrap),关键在于正确使用 Qt.TextFlag.TextWordWrap 标志 —— 它是专为 drawText() 设计的换行控制标识,不可与 QTextOption.WrapMode 混用(后者属于 QTextOption 类,用于 QTextDocument 或富文本布局场景,直接传入 drawText() 会导致类型错误或崩溃)。

✅ 正确写法如下(适配你的原始代码):

在Android
在Android

本文档主要讲述的是在Android-Studio中导入Vitamio框架;介绍了如何将Vitamio框架以Module的形式添加到自己的项目中使用,这个方法也适合导入其他模块实现步骤。希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看

下载
from PySide6.QtCore import Qt, QRect
from PySide6.QtGui import QPainter

# 假设 painter 已初始化,self.* 为已有属性
rectangle = QRect(self.startX, self.startY, int(self.Width), int(self.Length))
painter.fillRect(rectangle, self.colorList[i])
painter.drawText(
    rectangle,
    Qt.AlignmentFlag.AlignCenter | Qt.TextFlag.TextWordWrap,  # ✅ 正确组合:对齐 + 换行标志
    self.AssiName[i]  # 注意:问题中变量名疑似笔误,应为 self.AssiName[i] 而非 self.AssName[i]
)
painter.drawRect(rectangle)

⚠️ 注意事项:

  • Qt.TextFlag.TextWordWrap 是 PySide6(及 PyQt6)中 drawText() 唯一支持的原生换行标志,必须与 Qt.AlignmentFlag 按位或(|)组合使用;
  • 不要导入或使用 QTextOption(如 QTextOption.WrapMode.WordWrap),它不适用于 QPainter.drawText(),强行传入将引发 TypeError 或运行时崩溃;
  • 文本换行行为依赖矩形宽度:若高度不足,换行后文字可能被截断;建议确保矩形高度足够容纳多行文本(可结合 fontMetrics().boundingRect() 预估所需高度);
  • 若需更精细控制(如省略号、行距、HTML 渲染),应改用 QTextDocument + drawContents(),但会显著增加复杂度,普通标签式文本推荐坚持 drawText() + TextWordWrap 方案。

总结:只需将原错误写法
Qt.AlignmentFlag.AlignCenter | QTextOption.WrapMode.WordWrap
替换为
Qt.AlignmentFlag.AlignCenter | Qt.TextFlag.TextWordWrap,
即可安全、高效地启用居中+自动换行功能,完美适配动态尺寸矩形的批量绘制场景。

相关专题

更多
视频后缀名都有哪些
视频后缀名都有哪些

视频后缀名都有avi、mpg、mpeg、rm、rmvb、flv、wmv、mov、mkv、ASF、M1V、M2V、MPE、QT、VOB、RA、RMJ、RMS、RAM、等等。更多关于视频后缀名的相关知识,详情请看本专题下面的文章,php中文网欢迎大家前来学习。

3414

2023.10.31

C++ Qt图形开发
C++ Qt图形开发

本专题专注于 C++ Qt框架在图形界面开发中的应用,系统讲解窗口设计、信号与槽机制、界面布局、事件处理、数据库连接与跨平台打包等核心技能,通过多个桌面应用项目实战,帮助学员快速掌握 Qt 框架并独立完成跨平台GUI软件的开发。

68

2025.08.15

C++ 图形界面开发基础(Qt方向)
C++ 图形界面开发基础(Qt方向)

本专题系统讲解 使用 C++ 与 Qt 进行图形界面(GUI)开发的核心技能,内容涵盖 Qt 项目结构、窗口组件、信号与槽机制、事件处理、布局管理、资源管理,以及跨平台编译与打包流程。通过多个小型桌面应用实战案例,帮助学习者掌握从界面设计到功能实现的完整 GUI 开发能力。

53

2025.12.05

html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

605

2023.06.14

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

644

2023.06.21

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

466

2023.07.31

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

245

2023.08.01

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2882

2023.08.11

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

97

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 5教程
Bootstrap 5教程

共46课时 | 2.9万人学习

AngularJS教程
AngularJS教程

共24课时 | 2.5万人学习

CSS教程
CSS教程

共754课时 | 18.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号