# QTextList Class Reference ## [[QtGui](index.htm) module] 該QTextList類提供了在一個項目的裝修清單[QTextDocument](qtextdocument.html)。[More...](#details) 繼承[QTextBlockGroup](qtextblockgroup.html)。 ### Methods * `__init__ (self, QTextDocument?doc)` * `add (self, QTextBlock?block)` * `int count (self)` * `QTextListFormat format (self)` * `bool isEmpty (self)` * `QTextBlock item (self, int?i)` * `int itemNumber (self, QTextBlock)` * `QString itemText (self, QTextBlock)` * `remove (self, QTextBlock)` * `removeItem (self, int?i)` * `setFormat (self, QTextListFormat?aformat)` ### Special Methods * `__len__ (self)` * * * ## Detailed Description 該QTextList類提供了在一個項目的裝修清單[QTextDocument](qtextdocument.html)。 列表中包含的序列的文本塊，其中的每一個標有符號點或其他符號。列出的多個層面都可以使用，并自動編號功能提供了有序的數字和字母順序列出了支持。 列表是通過使用文本光標插入一個空列表在當前位置或移動現有文本轉換成一個新的列表創建。該[QTextCursor.insertList](qtextcursor.html#insertList)（ ）函數插入光標所在位置的空塊插入到文檔中，并使其在列表中的第一個項目。 ``` [QTextListFormat](qtextlistformat.html) listFormat; if (list) { listFormat = list->format(); listFormat.setIndent(listFormat.indent() + 1); } listFormat.setStyle([QTextListFormat](qtextlistformat.html).ListDisc); cursor.insertList(listFormat); ``` 該[QTextCursor.createList](qtextcursor.html#createList)（ ）函數將光標的當前塊的內容，并把它變成一個新的列表中的第一項。 光標的當前列表中找到與[QTextCursor.currentList](qtextcursor.html#currentList)（ ） 。 列表中的項目的數目由下式給出[count](qtextlist.html#count)（ ） 。每個項目都可以通過其索引中的列表中獲得[item](qtextlist.html#item)（）函數。類似地，給定的項的索引可以找到[itemNumber](qtextlist.html#itemNumber)（ ） 。每個項的文本可以與被發現[itemText](qtextlist.html#itemText)（）函數。 請注意，列表中的項目可能無法在文件中相鄰元素。例如，在一個多級列表中的頂級項目將由項目列表中較低水平的分離。 列表項可以通過索引與刪除[removeItem](qtextlist.html#removeItem)（）函數。[remove](qtextlist.html#remove)（ ）刪除指定項在列表中。 該列表的格式設置與[setFormat](qtextlist.html#setFormat)（）和read與[format](qtextlist.html#format)（ ） 。該格式描述列表本身的裝飾，而不是單個項目。 * * * ## Method Documentation ``` QTextList.__init__ (self, QTextDocument?doc) ``` ``` QTextList.add (self, QTextBlock?block) ``` 使給定的_block_列表的一部分。 **See also** [remove](qtextlist.html#remove)（）和[removeItem](qtextlist.html#removeItem)（ ） 。 ``` int QTextList.count (self) ``` 返回的項目的列表中的號碼。 ``` QTextListFormat QTextList.format (self) ``` [ 返回列表的格式。 ](qtextlistformat.html) [**See also**](qtextlistformat.html) [setFormat](qtextlist.html#setFormat)（ ） 。 ``` bool QTextList.isEmpty (self) ``` ``` QTextBlock QTextList.item (self, int?i) ``` [ 返回_i_列表中的第文本塊。 ](qtextblock.html) [**See also**](qtextblock.html) [count](qtextlist.html#count)（）和[itemText](qtextlist.html#itemText)（ ） 。 ``` int QTextList.itemNumber (self, QTextBlock) ``` 返回對應于給定列表項的索引_block_。返回-1，如果塊沒有出現在清單中。 ``` QString QTextList.itemText (self, QTextBlock) ``` 返回對應于給定列表項的文本_block_。 ``` QTextList.remove (self, QTextBlock) ``` 刪除給定的_block_從列表中。 **See also** [add](qtextlist.html#add)（）和[removeItem](qtextlist.html#removeItem)（ ） 。 ``` QTextList.removeItem (self, int?i) ``` 在刪除項目位置的項目_i_從列表中。當在列表中的最后一個項目被刪除，該列表是由自動刪除[QTextDocument](qtextdocument.html)擁有它。 **See also** [add](qtextlist.html#add)（）和[remove](qtextlist.html#remove)（ ） 。 ``` QTextList.setFormat (self, QTextListFormat?aformat) ``` 設置列表的格式_format_。 **See also** [format](qtextlist.html#format)（ ） 。 ``` QTextList.__len__ (self) ```