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 參數分別設定為 tomTabletomRow 或 tomCell 這些單位也可以與 ITextRange::Move 方法搭配使用,以巡覽並選取多個數據列或單元格。

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

ITextRow 的運作方式類似於 ITextPara2,但在呼叫 ITextRow::ApplyITextRow::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、tomFalseNULL) 移至目前數據表的開頭,然後呼叫 ITextRange::Move (tomRow、tomForward、&dcRow) 來取得數據表中的數據列計數。 數量 &dcRow + 1 接著會包含數據表中的數據列計數,因為透過 tomRow 遞增移動並不會移動超過最後一個數據表數據列。

規格需求

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