iTextRow 介面 (tom.h)

ITextRow 介面提供方法來插入一或多個相同的數據表數據列，以及擷取和變更數據表數據列屬性。 若要插入非實體數據列，請針對每個不同的數據列組態呼叫 ITextRow：：Insert 。

繼承

ITextRow 介面繼承自 IDispatch 介面。 ITextRow 也有下列類型的成員：

方法

ITextRow 介面具有這些方法。

ITextRow：：Apply 將這個文字數據列物件的格式化屬性套用至相關聯 ITextRange2 中的指定數據列。
ITextRow：：CanChange 判斷是否可以對此數據列進行變更。
ITextRow：：GetAlignment 取得數據列的水準對齊方式。
ITextRow：：GetCellAlignment 取得使用中儲存格的垂直對齊方式。
ITextRow：：GetCellBorderColors 取得使用中儲存格的框線色彩。
ITextRow：：GetCellBorderWidths 取得使用中儲存格的框線寬度。
ITextRow：：GetCellColorBack 取得使用中儲存格的背景色彩。
ITextRow：：GetCellColorFore 取得使用中儲存格的前景色彩。
ITextRow：：GetCellCount 取得這個數據列中的儲存格計數。
ITextRow：：GetCellCountCache 取得為此數據列快取的儲存格計數。
ITextRow：：GetCellIndex 取得要取得或設定參數的作用中儲存格索引。
ITextRow：：GetCellMargin 取得這個數據列的儲存格邊界。
ITextRow：：GetCellMergeFlags 取得使用中儲存格的合併旗標。
ITextRow：：GetCellShading 取得使用中儲存格的底紋。
ITextRow：：GetCellVerticalText 取得使用中儲存格的垂直文字設定。
ITextRow：：GetCellWidth 取得使用中儲存格的寬度。
ITextRow：：GetHeight 取得數據列的高度。
ITextRow：：GetIndent 取得這個數據列的縮排。
ITextRow：：GetKeepTogether 取得是否允許跨頁面中斷此數據列。
ITextRow：：GetKeepWithNext 取得這個數據列是否應該出現在與其後面的數據列相同的頁面上。
ITextRow：：GetNestLevel 取得數據表的巢狀層級。
ITextRow：：GetProperty 取得指定的屬性值。 (ITextRow.GetProperty)
ITextRow：：GetRTL 取得這個數據列是否具有由右至左的方向。
ITextRow：：Insert 在相關聯的 ITextRange2 物件所識別的位置插入數據列或數據列。
ITextRow：：Isequal 比較兩個數據表數據列，以判斷它們是否有相同的屬性。
ITextRow：：Reset 重設數據列。
ITextRow：：SetAlignment 設定數據列的水準對齊方式。
ITextRow：：SetCellAlignment 設定使用中儲存格的垂直對齊方式。
ITextRow：：SetCellBorderColors 設定使用中儲存格的框線色彩。
ITextRow：：SetCellBorderWidths 設定使用中儲存格的框線寬度。
ITextRow：：SetCellColorBack 設定使用中儲存格的背景色彩。
ITextRow：：SetCellColorFore 設定使用中儲存格的前景色彩。
ITextRow：：SetCellCount 設定數據列中的儲存格計數。
ITextRow：：SetCellCountCache 設定針對數據列快取的儲存格計數。
ITextRow：：SetCellIndex 設定使用中儲存格的索引。
ITextRow：：SetCellMargin 設定數據列的儲存格邊界。
ITextRow：：SetCellMergeFlags 設定使用中儲存格的合併旗標。
ITextRow：：SetCellShading 設定使用中儲存格的底紋。
ITextRow：：SetCellVerticalText 設定使用中儲存格的垂直文字設定。
ITextRow：：SetCellWidth 以 twip 為單位設定使用中儲存格寬度。
ITextRow：：SetHeight 設定數據列的高度。
ITextRow：：SetIndent 設定數據列的縮排。
ITextRow：：SetKeepTogether 設定是否允許跨頁面中斷此數據列。
ITextRow：：SetKeepWithNext 設定數據列是否應該出現在與其後面的數據列相同的頁面上。
ITextRow：：SetProperty 設定指定之屬性的值。 (ITextRow.SetProperty)
ITextRow：：SetRTL 設定這個數據列是否具有由右至左的方向。

備註

若要選取數據表、數據列或單元格，請使用 ITextRange：：Expand，並將 Unit 參數分別設定為 tomTable、tomRow 或 tomCell。 這些單位也可以與 ITextRange：：Move 方法搭配使用，以巡覽並選取多個數據列或單元格。

某些 ITextRow 屬性會套用至整個數據列，例如數據列對齊方式。 此外，還有一些屬性，例如儲存格對齊，可套用至透過 ITextRow：：SetCellIndex 方法設定索引的儲存格。 此儲存格稱為使用中儲存格。

ITextRow 的運作方式類似於 ITextPara2，但在呼叫 ITextRow：：Apply 或 ITextRow：：Insert 方法之前，不會修改檔。 此外，數據列和單元格參數一律為使用中，也就是說，它們不能有 tomDefault 值。

在初始化時， ITextRow 物件會在相關聯的 ITextRange2 使用中結尾取得數據表數據列屬性。 ITextRow：：Reset 方法可用來將這些屬性更新為 ITextRange2 物件的目前值。

豐富的編輯控制項數據表是由一連串的數據表數據列所組成，接著由段落序列所組成。 表格列以特殊的雙字元分隔符段落 U+FFF9 U+000D 開頭，並以雙字元分隔符段落 U+FFFB U+000D 結尾。 每個儲存格都會由數據格標記 U+0007 終止，這被視為硬式段落標記，就像是 U+000D (CR) 一樣。 表格列和儲存格參數會被視為數據表數據列分隔符的特殊段落格式設定。 單元格參數會儲存在索引標籤列的擴充版本中。 此格式可讓數據表巢狀於其他數據表內，並允許深入 15 層。

架構相當有彈性，因此每個數據表數據列都可以有任何有效的數據表數據列參數，而不論其他數據列的參數為何， (除了垂直合併旗標) 。 例如，單元格數目和數據表數據列的開始縮排可能會不同，不同於 HTML，其具有 n×m 矩形格式，且所有數據列都是從相同的縮排開始。

另一方面，不會儲存任何正式數據表描述。 必須瀏覽資料表來找出數據列數目等資訊。 例如，您可以呼叫 ITextRange：：StartOf (tomTable、tomFalse、NULL) 移至目前數據表的開頭，然後呼叫 ITextRange：：Move (tomRow、tomForward、&dcRow) 來取得數據表中的數據列計數。 數量 &dcRow + 1 接著會包含數據表中的數據列計數，因為透過 tomRow 遞增移動並不會移動超過最後一個數據表數據列。

規格需求

需求	值
最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
目標平台	Windows
標頭	tom.h