WP INSERT DOCUMENT

4D v16

WP INSERT DOCUMENT


WP INSERT DOCUMENT ( rangeObj ; wpDoc ; mode {; rangeUpdate} )

引数	型	説明
rangeObj	Object	4D Write Pro レンジオブジェクト
wpDoc	Object	4D Wrie Pro ドキュメント
mode	倍長整数	挿入モード
rangeUpdate	倍長整数	レンジ更新モード

説明

WP INSERT DOCUMENT コマンドは mode や rangeUpdate で指定した方法で、rangeObj に指定されたレンジに wpDoc のドキュメントを挿入します。

rangeObj には有効な 4D Write Pro 標準のレンジオブジェクトを渡します。レンジオブジェクトは 4D Write Pro ドキュメントの一部で、次のコマンドを使用して作成することができます: , WP Get bookmark range, WP Get range。

挿入する wpDoc ドキュメントは WP New または WP Import document で作成された 4D Write Pro ドキュメントオブジェクトを受け渡すことができます。挿入されるのは本文の要素のみです (挿入先のセクションおよびブックマークは変更されません)。挿入は実質的にはコピー処理されるため、wpDoc は再利用することができます。

mode パラメーターには、rangeObj レンジにドキュメントを挿入する際の挿入モードを指定するために、4D Write Pro テーマから一つ以上の定数を受け渡します:

定数	型	値	コメント
wk append	倍長整数	2	コンテンツをレンジの終わりに挿入する
wk prepend	倍長整数	1	コンテンツをレンジの始めに挿入する
wk replace	倍長整数	0	レンジのコンテンツを置き換える

上に紹介した定数を、次の挿入オプションと組み合わせることができます:

定数	型	値	コメント
wk freeze expressions	倍長整数	64	挿入の瞬間に式を評価します。
wk inherit style from paragraph	倍長整数	32	挿入されたコンテンツは、段落のデフォルト文字スタイルを継承します。
wk keep paragraph styles	倍長整数	128	移行先の段落スタイルを保持します。

任意の rangeUpdate パラメーターには、次の定数のいずれか一つを渡して、挿入コンテンツを処理後のレンジに含めるかどうかを指定します:

定数	型	値	コメント
wk exclude from range	倍長整数	1	更新されたレンジには、以前のコンテンツのみを含める
wk include in range	倍長整数	0	更新されたレンジに挿入コンテンツを含める

rangeUpdate パラメーターを省略した場合 (デフォルト)、挿入コンテンツは処理後のレンジに含まれます。

例題 1

ドキュメントの内容を、他のドキュメント内で選択されたテキストで置き換える場合を考えます:

 $tempRange:=WP Get selection(WPTemplate) //WPTemplateドキュメント内のユーザーセレクションを取得

 $doctoCopy:=WP New($tempRange) //WPTemplateに基づいて新しいドキュメントを作成

 WP INSERT DOCUMENT(WPDoc;$doctoCopy;wk replace) //新しいドキュメントの中身でWPDocの中身を置き換え

例題 2

あらかじめフォーマットされ、それぞれがブックマークとして保存された複数のパーツで構成された、テンプレートドキュメントを定義しました。このテンプレートから任意のブックマークを新規ドキュメントとして抽出し、作成中のドキュメントに挿入することができます。

 ARRAY TEXT($_BookmarkNames;0)

 WP GET BOOKMARKS([TEMPLATES]WP;$_BookmarkNames) // テンプレートからブックマークを取得します

 $targetRange:=WP New //空のドキュメントを作成(これが最終的なドキュメントになります)

 

 $p:=Find in array($_BookmarkNames;"Main_Header") // 使用したいブックマークを名称で探します

 If($p>0)

    $Range:=WP Get bookmark range(WParea;$_BookmarkNames{$p}) // ブックマークからレンジを取得します

    $RangeDoc:=WP New($Range) // レンジから新規ドキュメントを作成します

    WP INSERT DOCUMENT($targetRange;$RangeDoc;wk append+wk freeze expressions) // wk append = $RangeDocドキュメントは $targetRange の先頭に挿入されます

 End if

参照

WP INSERT BREAK
WP INSERT PICTURE
WP New