EM_INSERTTABLE訊息
插入一或多個具有空白儲存格的相同資料表資料列。
#define EM_INSERTTABLE (WM_USER + 232)
參數
-
wParam
-
TABLEROWPARMS結構的指標。
-
lParam
-
TABLECELLPARMS結構的指標。
傳回值
如果插入資料表，則傳回S_OK，如果不是，則傳回錯誤碼。
備註
如果TABLEROWPARMS的cpStartRow成員是 –1，如果有任何) ，則此訊息會刪除選取的文字 (，然後使用wParam 和 lParam所提供的列和儲存格參數插入空的資料表資料列。 它會讓選取範圍指向第一列第一個儲存格的開頭。 然後，用戶端可以將選取範圍 (或 ITextRange) 指向各種儲存格結束記號，並插入及格式化所需的文字，以填入表格儲存格。 這類文字可以包含巢狀資料表資料列。 或者，如果TABLEROWPARMS的cpStartRow成員是 0 或更新版本，資料表資料列就會插入cpStartRow所提供的字元位置。 這只會在選取的文字內插入表格時變更目前的選取範圍。
Microsoft Rich Edit 資料表是由一系列資料表資料列所組成，而該資料列則由段落序列所組成。 資料表資料列以特殊的雙字元分隔符號段落 U+FFF9 U+000D 開頭，並以雙字元分隔符號段落 U+FFFB U+000D 結尾。 每一個儲存格都會由標示 U+0007 的儲存格終止，這會被視為硬式段落標記，就像 U+000D (CR) 一樣。 表格列和儲存格參數會被視為表格資料列分隔符號的特殊段落格式設定。 格式設定包含 TABLEROWPARMS 結構中的資訊。 TABLECELLPARMS結構所提供的儲存格參數會儲存在索引標籤陣列的擴充版本中。 此格式可讓資料表巢狀在其他資料表內，最多十五個層級的深度。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2012 [僅限傳統型應用程式] |
| 標頭 |
|