QTextBlockFormat Class Reference · PyQt4 中文文檔

# QTextBlockFormat Class Reference ## [[QtGui](index.htm) module] 該QTextBlockFormat類提供格式設置信息的文本在一個塊[QTextDocument](qtextdocument.html)。[More...](#details) 繼承[QTextFormat](qtextformat.html)。 ### Types * `enum LineHeightTypes { SingleHeight, ProportionalHeight, FixedHeight, MinimumHeight, LineDistanceHeight }` ### Methods * `__init__ (self)` * `__init__ (self, QTextBlockFormat)` * `Qt.Alignment alignment (self)` * `float bottomMargin (self)` * `int indent (self)` * `bool isValid (self)` * `float leftMargin (self)` * `float lineHeight (self, float?scriptLineHeight, float?scaling)` * `float lineHeight (self)` * `int lineHeightType (self)` * `bool nonBreakableLines (self)` * `QTextFormat.PageBreakFlags pageBreakPolicy (self)` * `float rightMargin (self)` * `setAlignment (self, Qt.Alignment?aalignment)` * `setBottomMargin (self, float?margin)` * `setIndent (self, int?aindent)` * `setLeftMargin (self, float?margin)` * `setLineHeight (self, float?height, int?heightType)` * `setNonBreakableLines (self, bool?b)` * `setPageBreakPolicy (self, QTextFormat.PageBreakFlags?flags)` * `setRightMargin (self, float?margin)` * `setTabPositions (self, list-of-QTextOption.Tab?tabs)` * `setTextIndent (self, float?margin)` * `setTopMargin (self, float?margin)` * `list-of-QTextOption.Tab tabPositions (self)` * `float textIndent (self)` * `float topMargin (self)` * * * ## Detailed Description 該QTextBlockFormat類提供格式設置信息的文本在一個塊[QTextDocument](qtextdocument.html)。文檔是由塊的列表為代表的[QTextBlock](qtextblock.html)對象。每個塊可以包含某種類型的產品，如一個文本段落，表格，列表或圖像。每個塊都有一個關聯的QTextBlockFormat ，指定其特性。為了照顧左到右，右到左的語言，你可以用setDirection （）設置一個塊的方向。段落對齊方式設置與[setAlignment](qtextblockformat.html#setAlignment)（）。利潤是由控制[setTopMargin](qtextblockformat.html#setTopMargin)（）[setBottomMargin](qtextblockformat.html#setBottomMargin)（）[setLeftMargin](qtextblockformat.html#setLeftMargin)（）[setRightMargin](qtextblockformat.html#setRightMargin)（）。整體縮進設置[setIndent](qtextblockformat.html#setIndent)（），與所述第一行的縮進[setTextIndent](qtextblockformat.html#setTextIndent)（）。行距設置與[setLineHeight](qtextblockformat.html#setLineHeight)（），并通過檢索[lineHeight](qtextblockformat.html#lineHeight)（）和[lineHeightType](qtextblockformat.html#lineHeightType)（）。行距可用的類型是在[LineHeightTypes](qtextblockformat.html#LineHeightTypes-enum)枚舉。斷行可以啟用和禁用[setNonBreakableLines](qtextblockformat.html#setNonBreakableLines)（）。用于繪制段落的背景的畫筆設置與[setBackground()](qtextformat.html#setBackground)和文本的外觀的其他方面可以通過使用自定義的[setProperty()](qtextformat.html#setProperty)與功能`OutlinePen`，`ForegroundBrush`和`BackgroundBrush` [QTextFormat.Property](qtextformat.html#Property-enum)值。如果文本塊是一個列表的一部分，它也可以有一個列表的格式，與該listFormat （）函數訪問。 * * * ## Type Documentation ``` QTextBlockFormat.LineHeightTypes ``` 這個枚舉變量描述了不同類型的線間距支持段落可以有。 | Constant | Value | Description | | --- | --- | --- | | `QTextBlockFormat.SingleHeight` | `0` | 這是默認行高：單倍行距。 | | `QTextBlockFormat.ProportionalHeight` | `1` | 這個設置的間距成正比線（百分比）。例如，設置為200雙間距。 | | `QTextBlockFormat.FixedHeight` | `2` | 這將設置行高為固定行高（以像素為單位）。 | | `QTextBlockFormat.MinimumHeight` | `3` | 此設置最小行高（以像素為單位）。 | | `QTextBlockFormat.LineDistanceHeight` | `4` | 這增加了線路之間的指定高度（以像素為單位）。 | 這個枚舉被引入或修改的Qt 4.8 。 **See also** [lineHeight](qtextblockformat.html#lineHeight)（）[lineHeightType](qtextblockformat.html#lineHeightType)（）和[setLineHeight](qtextblockformat.html#setLineHeight)（）。 * * * ## Method Documentation ``` QTextBlockFormat.__init__ (self) ``` 構造一個新的[QTextBlockFormat](qtextblockformat.html)。 ``` QTextBlockFormat.__init__ (self, QTextBlockFormat) ``` ``` Qt.Alignment QTextBlockFormat.alignment (self) ``` [ 返回段落的對齊方式。 ](index.htm) [**See also**](index.htm) [setAlignment](qtextblockformat.html#setAlignment)（）。 ``` float QTextBlockFormat.bottomMargin (self) ``` 返回段的下邊界。 **See also** [setBottomMargin](qtextblockformat.html#setBottomMargin)（）和[topMargin](qtextblockformat.html#topMargin)（）。 ``` int QTextBlockFormat.indent (self) ``` 返回段落的縮進。 **See also** [setIndent](qtextblockformat.html#setIndent)（）。 ``` bool QTextBlockFormat.isValid (self) ``` 返回True如果該塊格式是有效的，否則返回False 。 ``` float QTextBlockFormat.leftMargin (self) ``` 返回段落的左邊距。 **See also** [setLeftMargin](qtextblockformat.html#setLeftMargin)（）[rightMargin](qtextblockformat.html#rightMargin)（）和[indent](qtextblockformat.html#indent)（）。 ``` float QTextBlockFormat.lineHeight (self, float?scriptLineHeight, float?scaling) ``` 返回該行的高度，在基于由給定的腳本行的高度的段落_scriptLineHeight_和指定的_scaling_因素。返回的值也依賴于給定的[LineHeightType](qtextformat.html#Property-enum)該段以及作為[LineHeight](qtextformat.html#Property-enum)已經被設置為段設置。縮放是需要的高度，其中包括固定像素數量，能夠適當地調整它們進行打印。此功能被引入Qt的4.8 。 **See also** [LineHeightTypes](qtextblockformat.html#LineHeightTypes-enum)，[setLineHeight](qtextblockformat.html#setLineHeight)（）和[lineHeightType](qtextblockformat.html#lineHeightType)（）。 ``` float QTextBlockFormat.lineHeight (self) ``` 這將返回[LineHeight](qtextformat.html#Property-enum)屬性的段落。此功能被引入Qt的4.8 。 **See also** [LineHeightTypes](qtextblockformat.html#LineHeightTypes-enum)，[setLineHeight](qtextblockformat.html#setLineHeight)（）和[lineHeightType](qtextblockformat.html#lineHeightType)（）。 ``` int QTextBlockFormat.lineHeightType (self) ``` 這將返回[LineHeightType](qtextformat.html#Property-enum)該段的屬性。此功能被引入Qt的4.8 。 **See also** [LineHeightTypes](qtextblockformat.html#LineHeightTypes-enum)，[setLineHeight](qtextblockformat.html#setLineHeight)（）和[lineHeight](qtextblockformat.html#lineHeight)（）。 ``` bool QTextBlockFormat.nonBreakableLines (self) ``` 返回True如果段落中的行是不易碎，否則返回False 。 **See also** [setNonBreakableLines](qtextblockformat.html#setNonBreakableLines)（）。 ``` QTextFormat.PageBreakFlags QTextBlockFormat.pageBreakPolicy (self) ``` [](index.htm) [返回段落中的當前設置的分頁符政策。默認值是](index.htm)[QTextFormat.PageBreak_Auto](qtextformat.html#PageBreakFlag-enum)。這個函數中引入了Qt 4.2中。 **See also** [setPageBreakPolicy](qtextblockformat.html#setPageBreakPolicy)（）。 ``` float QTextBlockFormat.rightMargin (self) ``` 返回段落的右邊距。 **See also** [setRightMargin](qtextblockformat.html#setRightMargin)（）和[leftMargin](qtextblockformat.html#leftMargin)（）。 ``` QTextBlockFormat.setAlignment (self, Qt.Alignment?aalignment) ``` 設置段落的_alignment_。 **See also** [alignment](qtextblockformat.html#alignment)（）。 ``` QTextBlockFormat.setBottomMargin (self, float?margin) ``` 設置段落的底部_margin_。 **See also** [bottomMargin](qtextblockformat.html#bottomMargin)（）[setTopMargin](qtextblockformat.html#setTopMargin)（）[setLeftMargin](qtextblockformat.html#setLeftMargin)（）和[setRightMargin](qtextblockformat.html#setRightMargin)（）。 ``` QTextBlockFormat.setIndent (self, int?aindent) ``` 設置段落的_indentation_。邊距獨立設置的凹槽構成的[setLeftMargin](qtextblockformat.html#setLeftMargin)（）和[setTextIndent](qtextblockformat.html#setTextIndent)（）。該_indentation_是一個整數相乘與廣泛的文檔標準的縮進，導致該段的實際縮進。 **See also** [indent](qtextblockformat.html#indent)（）和[QTextDocument.indentWidth](qtextdocument.html#indentWidth-prop)（）。 ``` QTextBlockFormat.setLeftMargin (self, float?margin) ``` 設置段落的左_margin_。壓痕可分別與應用[setIndent](qtextblockformat.html#setIndent)（）。 **See also** [leftMargin](qtextblockformat.html#leftMargin)（）[setRightMargin](qtextblockformat.html#setRightMargin)（）[setTopMargin](qtextblockformat.html#setTopMargin)（）和[setBottomMargin](qtextblockformat.html#setBottomMargin)（）。 ``` QTextBlockFormat.setLineHeight (self, float?height, int?heightType) ``` 設置行高的段落，通過給定的值_height_這是依賴于_heightType_在由所述的方式[LineHeightTypes](qtextblockformat.html#LineHeightTypes-enum)枚舉。此功能被引入Qt的4.8 。 **See also** [LineHeightTypes](qtextblockformat.html#LineHeightTypes-enum)，[lineHeight](qtextblockformat.html#lineHeight)（）和[lineHeightType](qtextblockformat.html#lineHeightType)（）。 ``` QTextBlockFormat.setNonBreakableLines (self, bool?b) ``` If _b_誠然，在該段線路被視為非易碎，否則他們是易碎的。 **See also** [nonBreakableLines](qtextblockformat.html#nonBreakableLines)（）。 ``` QTextBlockFormat.setPageBreakPolicy (self, QTextFormat.PageBreakFlags?flags) ``` 設置為段落分頁政策_policy_。這個函數中引入了Qt 4.2中。 **See also** [pageBreakPolicy](qtextblockformat.html#pageBreakPolicy)（）。 ``` QTextBlockFormat.setRightMargin (self, float?margin) ``` 設置段落的權利_margin_。 **See also** [rightMargin](qtextblockformat.html#rightMargin)（）[setLeftMargin](qtextblockformat.html#setLeftMargin)（）[setTopMargin](qtextblockformat.html#setTopMargin)（）和[setBottomMargin](qtextblockformat.html#setBottomMargin)（）。 ``` QTextBlockFormat.setTabPositions (self, list-of-QTextOption.Tab?tabs) ``` 設置文本塊的制表符位置，以那些由指定的_tabs_。此功能被引入Qt的4.4 。 **See also** [tabPositions](qtextblockformat.html#tabPositions)（）。 ``` QTextBlockFormat.setTextIndent (self, float?margin) ``` 設置_indent_對于在塊中的第一行。這允許一個段落的第一行縮進不同的其他線，提高文字的可讀性。 **See also** [textIndent](qtextblockformat.html#textIndent)（）[setLeftMargin](qtextblockformat.html#setLeftMargin)（）[setRightMargin](qtextblockformat.html#setRightMargin)（）[setTopMargin](qtextblockformat.html#setTopMargin)（）和[setBottomMargin](qtextblockformat.html#setBottomMargin)（）。 ``` QTextBlockFormat.setTopMargin (self, float?margin) ``` 設置段落的頂部_margin_。 **See also** [topMargin](qtextblockformat.html#topMargin)（）[setBottomMargin](qtextblockformat.html#setBottomMargin)（）[setLeftMargin](qtextblockformat.html#setLeftMargin)（）和[setRightMargin](qtextblockformat.html#setRightMargin)（）。 ``` list-of-QTextOption.Tab QTextBlockFormat.tabPositions (self) ``` 返回的文本塊中定義的選項卡位置的列表。此功能被引入Qt的4.4 。 **See also** [setTabPositions](qtextblockformat.html#setTabPositions)（）。 ``` float QTextBlockFormat.textIndent (self) ``` 返回段落的文本縮進。 **See also** [setTextIndent](qtextblockformat.html#setTextIndent)（）。 ``` float QTextBlockFormat.topMargin (self) ``` 返回段的上邊界。 **See also** [setTopMargin](qtextblockformat.html#setTopMargin)（）和[bottomMargin](qtextblockformat.html#bottomMargin)（）。