WP SET TEXT

4D v17

WP SET TEXT


WP SET TEXT ( wpRange ; newText ; textPosition {; rangeUpdate} )

引数	型	説明
wpRange	Object	レンジオブジェクト
newText	テキスト	挿入するテキスト
textPosition	Number	挿入位置(置き換え、前、後)
rangeUpdate	Number	挿入されたコンテンツをレンジに含める、あるいは含めない

説明

WP SET TEXT コマンドは、newText 引数に渡されたテキストを、4D Write Proドキュメント内のwpRange および textPosition 引数で指定された位置に標準テキストとして挿入します。.

wpRange 引数には、テキストが挿入される位置を指定するレンジオブジェクトを渡します。レンジは4D Write Pro ドキュメント内の明示的な位置も取れますし、ユーザーの選択に基づいた位置も選択できます。

newText 引数にはwpRange 引数で指定したレンジ内に挿入されるテキストを渡します。WP SET TEXT は標準テキストのみを挿入します。書かれた通りにテキストを挿入しますが、スタイルタグは除外されます。

textPosition 引数には、挿入されるテキストの位置を指定する、以下のセレクターのいずれかを渡すことができます:

定数	コメント
wk append	コンテンツをターゲットの終わりに挿入する
wk prepend	コンテンツをターゲットの始めに挿入する
wk replace	ターゲットのコンテンツを置き換える

任意のrangeUpdate 引数には、挿入されたコンテンツが返されたレンジに含まれるかどうかを指定する、以下の定数のいずれかを渡すことができます:

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

例題

以下のドキュメントにテキストを追加したい場合を考えます:

既存のテキストの前に挿入:

 $range:=WP Create range(myDoc;wk start text;wk end text)

 WP SET TEXT($range;" Hello world!";wk prepend)

  //書き換えたあとは " Hello world! The quick brown fox jumps over the lazy dog."となる

既存のテキストの後に挿入:

 $range:=WP Create range(myDoc;wk start text;wk end text)

 WP SET TEXT($range;" Hello world!";wk append)

  //書き換えたあとは "The quick brown fox jumps over the lazy dog. Hello world!"となる

既存のテキストを置き換える:

 $range:=WP Create range(myDoc;wk start text;wk end text)

 WP SET TEXT($range;" Hello world!";wk replace)

  //書き換えたあとは" Hello world!"となる

参照

WP Get text