# QTextListFormat Class Reference ## [[QtGui](index.htm) module] 該QTextListFormat類提供的格式設置信息列表[QTextDocument](qtextdocument.html)。[More...](#details) 繼承[QTextFormat](qtextformat.html)。 ### Types * `enum Style { ListDisc, ListCircle, ListSquare, ListDecimal, ..., ListUpperRoman }` ### Methods * `__init__ (self)` * `__init__ (self, QTextListFormat)` * `int indent (self)` * `bool isValid (self)` * `QString numberPrefix (self)` * `QString numberSuffix (self)` * `setIndent (self, int?aindent)` * `setNumberPrefix (self, QString?np)` * `setNumberSuffix (self, QString?ns)` * `setStyle (self, Style?astyle)` * `Style style (self)` * * * ## Detailed Description 該QTextListFormat類提供的格式設置信息列表[QTextDocument](qtextdocument.html)。 列表是由一個或多個項，表示為文本塊。該列表的格式指定的項目在列表中出現。特別是，它確定每個項目的縮進和樣式。 的項目的縮進是一個整數值，使得每個項被從左邊界由一定量的偏移量。該值與讀[indent](qtextlistformat.html#indent)（ ），并設置用[setIndent](qtextlistformat.html#setIndent)（ ） 。 用來裝飾每個項目的樣式設置與[setStyle](qtextlistformat.html#setStyle)（ ），并且可以讀取與該[style](qtextlistformat.html#style)（）函數。該樣式控制的要點，并用于列表中的項目編號方案的類型。請注意，使用十進制編號方案列表從1開始，而不是0開始計數。 樣式屬性可以設置為進一步配置列表項的外觀，例如，在[ListNumberPrefix](qtextformat.html#Property-enum)和[ListNumberSuffix](qtextformat.html#Property-enum)屬性可以被使用，以便它們顯示為（1 ），（2 ），（3 ）等來定制在一個有序列表中使用的數字： ``` QTextListFormat listFormat; listFormat.setStyle(QTextListFormat.ListDecimal); listFormat.setNumberPrefix("("); listFormat.setNumberSuffix(")"); cursor.insertList(listFormat); ``` * * * ## Type Documentation ``` QTextListFormat.Style ``` 這個枚舉描述用來裝飾清單項目符號： | Constant | Value | Description | | --- | --- | --- | | `QTextListFormat.ListDisc` | `-1` | 實心圓 | | `QTextListFormat.ListCircle` | `-2` | 空圈 | | `QTextListFormat.ListSquare` | `-3` | 一個填充的正方形 | | `QTextListFormat.ListDecimal` | `-4` | 按升序排列十進制值 | | `QTextListFormat.ListLowerAlpha` | `-5` | 按字母順序排列小寫拉丁字符 | | `QTextListFormat.ListUpperAlpha` | `-6` | 按字母順序排列大寫拉丁字符 | | `QTextListFormat.ListLowerRoman` | `-7` | 小寫羅馬數字（截至4999項僅支持） | | `QTextListFormat.ListUpperRoman` | `-8` | 大寫羅馬數字（截至4999項僅支持） | * * * ## Method Documentation ``` QTextListFormat.__init__ (self) ``` 構造一個新的列表格式的對象。 ``` QTextListFormat.__init__ (self, QTextListFormat) ``` ``` int QTextListFormat.indent (self) ``` 返回列表格式的縮進。壓痕乘以[QTextDocument.indentWidth](qtextdocument.html#indentWidth-prop)財產得到有效的縮進以像素為單位。 **See also** [setIndent](qtextlistformat.html#setIndent)（ ） 。 ``` bool QTextListFormat.isValid (self) ``` 返回True如果此列表的格式是有效的，否則返回False 。 ``` QString QTextListFormat.numberPrefix (self) ``` 返回列表格式的號碼前綴。 此功能被引入Qt的4.8 。 **See also** [setNumberPrefix](qtextlistformat.html#setNumberPrefix)（ ） 。 ``` QString QTextListFormat.numberSuffix (self) ``` 返回列表格式的數字后綴。 此功能被引入Qt的4.8 。 **See also** [setNumberSuffix](qtextlistformat.html#setNumberSuffix)（ ） 。 ``` QTextListFormat.setIndent (self, int?aindent) ``` 設置列表格式的_indentation_。壓痕乘以[QTextDocument.indentWidth](qtextdocument.html#indentWidth-prop)財產得到有效的縮進以像素為單位。 **See also** [indent](qtextlistformat.html#indent)（ ） 。 ``` QTextListFormat.setNumberPrefix (self, QString?np) ``` 設置列表格式的號碼前綴由指定的字符串_numberPrefix_。這可以用于所有排序的列表類型。它不會對未排序的列表類型的任何影響。 默認前綴是一個空字符串。 此功能被引入Qt的4.8 。 **See also** [numberPrefix](qtextlistformat.html#numberPrefix)（ ） 。 ``` QTextListFormat.setNumberSuffix (self, QString?ns) ``` 設置列表格式的數字后綴由指定的字符串_numberSuffix_。這可以用于所有排序的列表類型。它不會對未排序的列表類型的任何影響。 默認的后綴是“ 。” 此功能被引入Qt的4.8 。 **See also** [numberSuffix](qtextlistformat.html#numberSuffix)（ ） 。 ``` QTextListFormat.setStyle (self, Style?astyle) ``` 設置列表格式的_style_。 **See also** [style](qtextlistformat.html#style)（）和[Style](qtextlistformat.html#Style-enum)。 ``` Style QTextListFormat.style (self) ``` [ 返回列表格式的風格。 ](qtextlistformat.html#Style-enum) [**See also**](qtextlistformat.html#Style-enum) [setStyle](qtextlistformat.html#setStyle)（）和[Style](qtextlistformat.html#Style-enum)。