用于非html内容的QTextDocument样式表

QTextDocument 是 Qt 框架中的一个类，用于处理富文本文档。它可以与 QTextEdit 或 QPlainTextEdit 配合使用，以显示和编辑复杂的文本格式。样式表（Style Sheets）在 QTextDocument 中用于定义文本的外观，类似于网页中的 CSS。

基础概念

样式表：样式表是一系列规则，用于定义文档中元素的样式。在 QTextDocument 中，样式表可以用来设置字体、颜色、对齐方式等。

QTextCharFormat：这是一个类，用于设置单个字符或文本片段的格式。

QTextBlockFormat：用于设置文本块的格式，如段落的对齐方式、缩进等。

QTextListFormat：用于设置列表的格式，如项目符号或编号。

相关优势

1. 灵活性：样式表允许开发者精确控制文档的外观。
2. 可维护性：通过集中管理样式，可以更容易地更新和维护文档的外观。
3. 性能：预定义的样式可以提高渲染速度，因为不需要每次都重新计算样式。

类型

• 内联样式：直接应用在特定文本片段上的样式。
• 内部样式表：定义在文档内部的样式表，通常位于文档的开始部分。
• 外部样式表：存储在单独文件中的样式表，可以通过链接引用到文档中。

应用场景

• 报告生成：创建具有统一风格的报告。
• 富文本编辑器：在文本编辑器中实现格式化功能。
• 邮件客户端：设置邮件的显示样式。

示例代码

以下是一个简单的例子，展示如何在 QTextDocument 中使用样式表：

from PyQt5.QtWidgets import QApplication, QTextEdit
from PyQt5.QtGui import QTextDocument

app = QApplication([])

text_edit = QTextEdit()
document = text_edit.document()

# 设置样式表
style_sheet = """
    body { font-family: Arial; font-size: 12pt; }
    h1 { color: blue; font-size: 18pt; }
    p { color: green; }
"""

document.setDefaultStyleSheet(style_sheet)

# 添加一些文本
text_edit.setHtml("""
    <h1>标题</h1>
    <p>这是一个段落。</p>
""")

text_edit.show()
app.exec_()

遇到的问题及解决方法

问题：样式表没有正确应用到文档上。

原因：

• 样式表语法错误。
• 样式选择器不正确，无法匹配到目标元素。
• 样式表没有被正确设置到 QTextDocument 上。

解决方法：

• 检查样式表语法是否正确。
• 确保选择器能够匹配到需要应用样式的元素。
• 使用 setDefaultStyleSheet 方法确保样式表被设置到文档上。

通过以上信息，你应该能够理解 QTextDocument 样式表的基础概念、优势、类型、应用场景，以及如何解决常见问题。