WP SELECT

4D v16

WP SELECT


WP SELECT ( {* ;} wpArea {; rangeObj}{; startRange ; endRange} )

引数	型	説明
*	演算子	指定時、wpAreaはフォームオブジェクト名(文字列)。省略時、wpAreaはオブジェクトフィールドまたは変数。
wpArea	文字, Object	フォームオブジェクト名(指定時)または4D Write Proオブジェクト変数またはフィールド(省略時)
rangeObj	Object	セレクションを作成するのに使用するレンジオブジェクト
startRange	倍長整数	テキストレンジの開始のオフセット
endRange	倍長整数	テキストレンジの終わりのオフセット

説明

WP SELECTコマンドはwpArea引数で指定した4D Write Proエリアから、rangeObjまたはstartRangeとendRangeで定義された新しい範囲に基づく新しいテキストのセレクションを作成します。

任意の * 引数を渡した場合、wpArea引数がフォームオブジェクト名(文字列)であることを指示します。この引数を省略した場合、wpArea引数が4D Write Proオブジェクト変数あるいはフィールドであることを指示します。wpArea引数に有効な4D Write Proエリアが渡されなかった場合、このコマンドは何もしません。

選択のレンジを定義するためには、既存のレンジオブジェクトをrangeObj引数に渡すか、範囲を指定するstartRange / endRangeのペアを渡します:

第一シンタックス: WP SELECT({* ;} wpArea ; rangeObj)
rangeObjは4D Write Proドキュメントの一部です。これはWP Get range、、WP Get paragraphs、あるいはWP Get pictures等の別のコマンドを使用して作成する事ができます。

第二シンタックス: WP SELECT({* ;} wpArea ; startRange ; endRange)
この場合、startRangeとendRange引数にはドキュメントで選択したい最初の文字と最後の文字の位置に対応する値を渡します。startRange引数にwk start text定数を渡す事でドキュメントの最初を定義する事ができ、またendRange引数にwk end text定数を渡す事でドキュメントの最後を定義する事ができます。4D Write Proドキュメントは表示されているテキストだけではなく範囲内に含まれるフォーマットタグもあるという点に注意して下さい。

例題

以下のコードは:

 $range2:=WP Get range([SAMPLE]WP;wk start text;12)

 WP SELECT(*;"WParea";$range2)

... このコードと同じ意味になります:

WP SELECT(*;"WParea";wk start text;12)

参照

WP Get range