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,
即可安全、高效地启用居中+自动换行功能,完美适配动态尺寸矩形的批量绘制场景。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

3830

2023.10.31

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

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

75

2025.08.15

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

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

100

2025.12.05

word背景色怎么改成白色
word背景色怎么改成白色

Word是微软公司的一个文字处理器软件。word为用户提供了专业而优雅的文档工具,帮助用户节省时间并得到优雅美观的结果。word提供了许多易于使用的文档创建工具,同时也提供了丰富的功能供创建复杂的文档使用。怎么word背景色怎么该呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3736

2023.07.21

word最后一页空白页怎么删除
word最后一页空白页怎么删除

word最后一页空白页删除方法有:通过删除回车符、调整页边距、删除分节符或调整分页符位置,您可以轻松去除最后一页的空白页。根据您实际的文档情况,选择适合您的方法进行操作,使您的文档更加美观和整洁。本专题为大家提供word最后一页空白页怎么删除不了相关的各种文章、以及下载和课程。

337

2023.07.24

word最后一页空白页怎么删除不了
word最后一页空白页怎么删除不了

word删除最后一页空白页,可以尝试使用Backspace键删除空白页,如果无效,查找和删除分页符,或者调整页面边距和行距。还可以尝试将文档保存为其他格式并重新打开和保存。本专题为大家提供word最后一页空白页为啥删除不了的相关的文章、下载、课程内容,供大家免费下载体验。

376

2023.07.25

word单页改变纸张方向
word单页改变纸张方向

word单页改变纸张方向:1、在界面上选择文档纸张方向;2、自定义页面设置;3、分节功能。本专题为大家提供word单页改变纸张方向的相关的文章、下载、课程内容,供大家免费下载体验。

624

2023.07.27

word转ppt
word转ppt

Word是一款常用的文字处理软件,而PowerPoint则是一款专门用于制作演示文稿的软件。在某些情况下,我们可能需要将Word文档转换为PowerPoint演示文稿,以便更好地展示我们的内容。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

382

2023.08.03

Golang 测试体系与代码质量保障:工程级可靠性建设
Golang 测试体系与代码质量保障:工程级可靠性建设

Go语言测试体系与代码质量保障聚焦于构建工程级可靠性系统。本专题深入解析Go的测试工具链(如go test)、单元测试、集成测试及端到端测试实践,结合代码覆盖率分析、静态代码扫描(如go vet)和动态分析工具,建立全链路质量监控机制。通过自动化测试框架、持续集成(CI)流水线配置及代码审查规范,实现测试用例管理、缺陷追踪与质量门禁控制,确保代码健壮性与可维护性,为高可靠性工程系统提供质量保障。

48

2026.02.28

热门下载

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

精品课程

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

共46课时 | 3.5万人学习

AngularJS教程
AngularJS教程

共24课时 | 3.9万人学习

CSS教程
CSS教程

共754课时 | 38.4万人学习

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

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