class QTextListFormat#

QTextListFormat 类提供 QTextDocument 中列表的格式化信息。更多信息...

Inheritance diagram of PySide6.QtGui.QTextListFormat

概要#

方法#

注意

本文档可能包含从C++自动翻译到Python的片段。我们始终欢迎对片段翻译的贡献。如果您发现翻译有问题，也可以通过在https:/bugreports.qt.io/projects/PYSIDE创建工单来告知我们。

详细描述#

警告

本节包含从C++自动翻译到Python的片段，可能包含错误。

列表由一个或多个项目组成，代表为文本块。列表的格式指定列表中项目的外观。特别是，它确定每个项目的缩进和样式。

项目的缩进是一个整数值，使得每个项目从左边距偏移一定量。此值通过indent()读取，通过setIndent()设置。

用于装饰每个项目的样式通过setStyle()设置，可以通过style()函数读取。样式控制列表中项目使用的项目符号和编号方案。请注意，使用十进制编号方案的列表从1开始计数，而不是从0开始，除非通过setStart()覆盖。

样式属性可以设置以进一步配置列表项的外观；例如，可以使用ListNumberPrefix和ListNumberSuffix属性来自定义有序列表中使用的数字，使其显示为（1），（2），（3）等。

listFormat = QTextListFormat()
listFormat.setStyle(QTextListFormat.ListDecimal)
listFormat.setNumberPrefix("(")
listFormat.setNumberSuffix(")")
cursor.insertList(listFormat)

另请参阅

QTextList

class Style#

此枚举描述了用于装饰列表项的符号

常量

说明

QTextListFormat.ListDisc

一个实心圆

QTextListFormat.ListCircle

一个空心圆

QTextListFormat.ListSquare

一个实心方块

QTextListFormat.ListDecimal

升序排列的十进制值

QTextListFormat.ListLowerAlpha

按字母顺序排列的小写拉丁字母

QTextListFormat.ListUpperAlpha

按字母顺序排列的大写拉丁字母

QTextListFormat.ListLowerRoman

小写罗马数字（仅支持最多4999个项目）

QTextListFormat.ListUpperRoman

大写罗马数字（仅支持最多4999个项目）
__init__()#

构建一个新的列表格式对象。

__init__(fmt)
参数：:

fmt – QTextFormat

indent()#
返回类型：:

int

获取列表格式的缩进。缩进乘以indentWidth属性以得到像素值中的实际缩进。

另请参阅

setIndent()

numberPrefix()#
返回类型：:

str

返回列表格式的数字前缀。

另请参阅

setNumberPrefix()

numberSuffix()#
返回类型：:

str

返回列表格式的数字后缀。

另请参阅

setNumberSuffix()

setIndent(indent)#
参数：:

indent – int

设置列表格式的缩进。缩进乘以indentWidth属性以得到像素值中的实际缩进。

另请参阅

indent()

setNumberPrefix(numberPrefix)#
参数：:

numberPrefix – str

将列表格式的数字前缀设置为由numberPrefix指定的字符串。这可以用于所有排序的列表类型。对未排序列表类型没有影响。

默认前缀为空字符串。

另请参阅

numberPrefix()

setNumberSuffix(numberSuffix)#
参数：:

numberSuffix – str

将列表格式的数字后缀设置为由numberSuffix指定的字符串。这可以用于所有排序的列表类型。对未排序列表类型没有影响。

默认后缀为“.”。

另请参阅

numberSuffix()

setStart(start)#
参数：:

indent – int

设置列表格式的起始索引。

这允许您以除1以外的索引开始列表。这可以用于所有排序的列表类型：例如，如果style是ListLowerAlpha且start是4，则第一个列表项以“d”开头。对未排序列表类型没有影响。

默认起始值为1。

另请参阅

start()

setStyle(style)#
参数：:

style – Style

设置列表格式的 style。

另请参阅

style() Style

start()#
返回类型：:

int

如果 style() 是 ListDecimal ，则返回第一个列表项将显示的数字，或用于其他排序列表类型的偏移量。

另请参阅

setStart()

style()#
返回类型：:

风格

返回列表格式的风格。

另请参阅

setStyle() Style