类 QTextList#

QTextList 类提供了一个 QTextDocument 中项的装饰列表。《更多》

Inheritance diagram of PySide6.QtGui.QTextList

概要

方法

注意

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

详细描述

警告

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

列表包含一系列文本块，每个文本块都用项目符号或其他符号标记。可以使用多级列表，自动编号功能为有序数字和字母列表提供支持。

创建列表可以通过使用文本光标在当前位置插入一个空列表或通过将现有文本移动到新列表中来实现。函数insertList()将一个空块插入到光标位置，并将其设置为列表的第一个条目。

listFormat = QTextListFormat()
if list:
    listFormat = list.format()
    listFormat.setIndent(listFormat.indent() + 1)

listFormat.setStyle(QTextListFormat.ListDisc)
cursor.insertList(listFormat)

函数createList()将光标当前块的文本转换为新列表的第一个条目。

使用函数currentList()查找光标的当前列表。

列表中的项目数量由函数count()提供。每个项目可以通过列表中的索引通过函数item()获取。类似地，给定项的索引可以通过函数itemNumber()找到。每个项目的文本可以通过函数itemText()找到。

请注意，列表中的项目可能不是文档中的相邻元素。例如，多级列表的顶级项目将由列表较低级别的项目分隔。

可以使用函数removeItem()通过索引删除列表项。函数remove()删除列表中指定的项目。

使用函数setFormat()设置列表的格式，并使用函数format()读取格式。格式描述的是列表本身的装饰，而不是各个项。

__init__(doc)#
参数：

doc – QTextDocument

add(block)#
参数：

block – QTextBlock

将指定的 block 设为列表的一部分。

另请参阅

remove() removeItem()

count()#
返回类型:

int

返回列表中的项数。

format()#
返回类型:

QTextListFormat

返回列表的格式。

另请参阅

setFormat()

item(i)#
参数：

i – int

返回类型:

QTextBlock

返回列表中的第 i 个文本块。

另请参阅

count() itemText()

itemNumber(arg__1)#
参数：

arg__1 – QTextBlock

返回类型:

int

返回与给定 block 对应的列表项的索引。如果该块不在列表中，则返回 -1。

itemText(arg__1)#
参数：

arg__1 – QTextBlock

返回类型:

str

返回与给定 block 对应的列表项的文本。

remove(arg__1)#
参数：

arg__1 – QTextBlock

从列表中移除指定的 block。

另请参阅

add() removeItem()

removeItem(i)#
参数：

i – int

从列表中移除位于 i 位置的项。当移除列表中的最后一项时，拥有的 QTextDocument 将自动删除列表。

另请参阅

add() remove()

setFormat(format)#
参数：

format – QTextListFormat

将列表格式设置为 format。

另请参阅

format()