# QTextTableFormat Class Reference ## [[QtGui](index.htm) module] 該QTextTableFormat類提供的格式設置信息表[QTextDocument](qtextdocument.html)。[More...](#details) 繼承[QTextFrameFormat](qtextframeformat.html)。 ### Methods * `__init__ (self)` * `__init__ (self, QTextTableFormat)` * `Qt.Alignment alignment (self)` * `float cellPadding (self)` * `float cellSpacing (self)` * `clearColumnWidthConstraints (self)` * `int columns (self)` * `list-of-QTextLength columnWidthConstraints (self)` * `int headerRowCount (self)` * `bool isValid (self)` * `setAlignment (self, Qt.Alignment?aalignment)` * `setCellPadding (self, float?apadding)` * `setCellSpacing (self, float?spacing)` * `setColumns (self, int?acolumns)` * `setColumnWidthConstraints (self, list-of-QTextLength?constraints)` * `setHeaderRowCount (self, int?count)` * * * ## Detailed Description 該QTextTableFormat類提供的格式設置信息表[QTextDocument](qtextdocument.html)。 表是一組細胞有序的行和列。每個表包含至少一行和一列。每個小區包含一個塊。在富文本文檔表格使用這個類中定義的屬性格式化。 他們的父框架內，根據表中的排列表水平合理。這可以讀取的[alignment](qtexttableformat.html#alignment)（ ）函數，并與集[setAlignment](qtexttableformat.html#setAlignment)（ ） 。 在表中的細胞通過細胞間距隔開。細胞之間的像素的數目被設置以[setCellSpacing](qtexttableformat.html#setCellSpacing)（）和read與[cellSpacing](qtexttableformat.html#cellSpacing)（ ） 。每個單元格的內容是由單元格填充包圍。每個小區邊緣與其內容之間的像素的數目被設置以[setCellPadding](qtexttableformat.html#setCellPadding)（）和read與[cellPadding](qtexttableformat.html#cellPadding)（ ） 。  表中的背景顏色，可以讀取與該[background](qtextformat.html#background)（）函數，并且可以與被指定[setBackground](qtextformat.html#setBackground)（ ） 。每一單元格的背景顏色可以單獨設置，并且將控制該填充區域內的單元格的顏色。 表格格式還提供了一種在表中約束的列的寬度。列可以被分配一個固定的寬度，寬度可變，或可用寬度的百分比（見[QTextLength](qtextlength.html)） 。該[columns](qtexttableformat.html#columns)（ ）函數返回一個約束的列數，以及[columnWidthConstraints](qtexttableformat.html#columnWidthConstraints)（ ）函數返回表中定義的約束。這些量也可以通過調用設置[setColumnWidthConstraints](qtexttableformat.html#setColumnWidthConstraints)（）用含有新的約束條件的載體。如果沒有限制是必需的，[clearColumnWidthConstraints](qtexttableformat.html#clearColumnWidthConstraints)（ ）可以用來刪除它們。 * * * ## Method Documentation ``` QTextTableFormat.__init__ (self) ``` 構造一個新的表格式對象。 ``` QTextTableFormat.__init__ (self, QTextTableFormat) ``` ``` Qt.Alignment QTextTableFormat.alignment (self) ``` [ 返回表的對齊方式。 ](index.htm) [**See also**](index.htm) [setAlignment](qtexttableformat.html#setAlignment)（ ） 。 ``` float QTextTableFormat.cellPadding (self) ``` 返回表的單元格填充。這描述了一種細胞，其內容的邊框之間的距離。 **See also** [setCellPadding](qtexttableformat.html#setCellPadding)（ ） 。 ``` float QTextTableFormat.cellSpacing (self) ``` 返回表的單元格間距。這描述了相鄰單元之間的距離。 **See also** [setCellSpacing](qtexttableformat.html#setCellSpacing)（ ） 。 ``` QTextTableFormat.clearColumnWidthConstraints (self) ``` 清除列寬限制為表。 **See also** [columnWidthConstraints](qtexttableformat.html#columnWidthConstraints)（）和[setColumnWidthConstraints](qtexttableformat.html#setColumnWidthConstraints)（ ） 。 ``` int QTextTableFormat.columns (self) ``` 返回由表格式中指定的列數。 ``` list-of-QTextLength QTextTableFormat.columnWidthConstraints (self) ``` 返回使用該表格格式來控制列在一個表中的出現的約束列表。 **See also** [setColumnWidthConstraints](qtexttableformat.html#setColumnWidthConstraints)（ ） 。 ``` int QTextTableFormat.headerRowCount (self) ``` 返回行的表中的定義的頭的數目。 這個函數中引入了Qt 4.2中。 **See also** [setHeaderRowCount](qtexttableformat.html#setHeaderRowCount)（ ） 。 ``` bool QTextTableFormat.isValid (self) ``` 返回True如果該表格式是有效的，否則返回False 。 ``` QTextTableFormat.setAlignment (self, Qt.Alignment?aalignment) ``` 設置表的_alignment_。 **See also** [alignment](qtexttableformat.html#alignment)（ ） 。 ``` QTextTableFormat.setCellPadding (self, float?apadding) ``` 設置單元格_padding_為表。這決定了細胞和其內容的邊框之間的距離。 **See also** [cellPadding](qtexttableformat.html#cellPadding)（ ） 。 ``` QTextTableFormat.setCellSpacing (self, float?spacing) ``` 設置單元格_spacing_為表。這決定了相鄰單元之間的距離。 **See also** [cellSpacing](qtexttableformat.html#cellSpacing)（ ） 。 ``` QTextTableFormat.setColumns (self, int?acolumns) ``` ``` QTextTableFormat.setColumnWidthConstraints (self, list-of-QTextLength?constraints) ``` 設置列寬_constraints_為表。 **See also** [columnWidthConstraints](qtexttableformat.html#columnWidthConstraints)（）和[clearColumnWidthConstraints](qtexttableformat.html#clearColumnWidthConstraints)（ ） 。 ``` QTextTableFormat.setHeaderRowCount (self, int?count) ``` 宣布第一_count_行的表的表頭。表格標題行重復得到，當一個表跨越頁邊界斷裂。 這個函數中引入了Qt 4.2中。 **See also** [headerRowCount](qtexttableformat.html#headerRowCount)（ ） 。