PySide6.QtGui.QTextList¶

class QTextList¶

QTextList 类提供了在 QTextDocument 中装饰的项目列表。更多…

概要¶

方法¶

def __init__()
def add()
def count()
def format()
def item()
def itemNumber()
def itemText()
def remove()
def removeItem()
def setFormat()

注意

本文档可能包含从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()读取。该格式描述的是列表本身的装饰，而不是单个项目。

另请参阅

QTextBlock QTextListFormat QTextCursor

__init__(doc)¶

Parameters:: 文档 – QTextDocument

add(block)¶

Parameters:: 块 – QTextBlock

使给定的block成为列表的一部分。

另请参阅

remove() removeItem()

count()¶

Return type:: 整数

返回列表中的项目数量。

format()¶

Return type:: QTextListFormat

返回列表的格式。

另请参阅

setFormat()

item(i)¶

Parameters:: i – 整数
Return type:: QTextBlock

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

另请参阅

count() itemText()

itemNumber(block)¶

Parameters:: 块 – QTextBlock
Return type:: 整数

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

itemText(block)¶

Parameters:: 块 – QTextBlock
Return type:: 字符串

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

remove(block)¶

Parameters:: 块 – QTextBlock

从列表中移除给定的 block。

另请参阅

add() removeItem()

removeItem(i)¶

Parameters:: i – 整数

从列表中移除位置为 i 的项目。当列表中的最后一个项目被移除时，列表会自动被拥有它的 QTextDocument 删除。

另请参阅

add() remove()

setFormat(format)¶

Parameters:: 格式 – QTextListFormat

将列表的格式设置为 format。

另请参阅

format()