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	Richedit.h

関連項目

EM_INSERTIMAGE