EM_INSERTTABLE メッセージ
空のセルを含む 1 つ以上の同一のテーブル行を挿入します。
#define EM_INSERTTABLE (WM_USER + 232)
パラメーター
-
wParam
-
TABLEROWPARMS 構造体へのポインター。
-
lParam
-
TABLECELLPARMS 構造体へのポインター。
戻り値
テーブルが挿入された場合はS_OKを返し、挿入されていない場合はエラー コードを返します。
Remarks
TABLEROWPARMS の cpStartRow メンバーが –1 の場合、このメッセージは選択したテキスト (存在する場合) を削除し、wParam と lParam によって指定された行パラメーターとセル パラメーターを含む空のテーブル行を挿入します。 選択範囲は、最初の行の最初のセルの先頭を指し示します。 その後、クライアントは、選択範囲 (または ITextRange) をさまざまなセルの終了マークにポイントし、目的のテキストを挿入および書式設定することで、表のセルを設定できます。 このようなテキストには、入れ子になったテーブル行を含めることができます。 または、TABLEROWPARMS の cpStartRow メンバーが 0 以上の場合は、cpStartRow によって指定された文字位置にテーブル行が挿入されます。 これにより、選択したテキスト内にテーブルが挿入されている場合にのみ、現在の選択範囲が変更されます。
Microsoft Rich Edit テーブルは、一連のテーブル行で構成され、その行は段落のシーケンスで構成されます。 テーブル行は、特殊な 2 文字区切り記号段落 U+FFF9 U+000D で始まり、2 文字区切り記号段落 U+FFFB U+000D で終わります。 各セルは、U+000D (CR) と同じようにハード段落末マークとして扱われるセル マーク U+0007 で終了します。 テーブル行パラメーターとセル パラメーターは、テーブル行区切り記号の特殊な段落書式として扱われます。 書式設定には、 TABLEROWPARMS 構造体の情報が含まれています。 TABLECELLPARMS 構造体によって指定されたセル パラメーターは、タブ配列の展開バージョンに格納されます。 この形式では、テーブルを他のテーブル内で入れ子にすることができ、最大 15 レベルの深さになります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2012 [デスクトップ アプリのみ] |
| Header |
|