WP Get text

4D v17

WP Get text


WP Get text ( targetObj {; expressions} ) -> 戻り値

引数	型	説明
targetObj	Object	4D Write Pro ドキュメント、レンジまたは要素の参照
expressions	Number	式の評価の指定
戻り値	テキスト	targetObjのテキスト

説明

WP Get text コマンドはtargetObj 引数で指定した4D Write Pro ドキュメントのテキストのコンテンツを取得します。

WP Get text は標準テキストのみを返します。適用されたスタイル(太字、イタリック、など)は全て無視されます。

targetObj 引数には、以下のいずれかを格納したオブジェクトを渡します:

レンジ
要素参照(表 / 段落 / 本文 / ヘッダー / フッター)
4D Write Pro ドキュメント

expressions 任意の引数は、targetObj 引数の中にある4D 式の評価の仕方を定義します。指定できるオプションは以下のとおりです:

定数	コメント
wk expressions as source	4D 式参照の元の文字列が返されます。
wk expressions as space	各参照は、ノンブレークスペース文字として返されます。
wk expressions as value	4D 式参照は評価された形式で返されます(オプションが渡されない際のデフォルト)。

重要: WP や ST コマンドで使用されるテキストレンジインデックスと同じになるのは、標準テキストにwk expressions as space を使用した場合のみです。WP やST コマンドでは常に式のサイズ=1 文字とみなすからです。

注:

targetObj 引数のオブジェクトにピクチャーが含まれる場合、そのピクチャーは無視され、スペース文字(" ")が返されます。
targetObj 引数のオブジェクトに表が含まれる場合、各セルのコンテンツが個別の段落として扱われ、タブ区切りされたテキストとして返されます。行はキャリッジリターンで分割されます。

例題

以下のドキュメント内のテキストを取得したい場合を考えます:

以下のように書くことができます:

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

 vText:=WP Get text($range;wk expressions as value) // "Hello world! Today is: 06/03/18." を返す

 vText2:=WP Get text($range;wk expressions as source) // "Hello world! Today is: Current date." を返す

 vText3:=WP Get text($range;wk expressions as space) // "Hello world! Today is:  ." を返す

参照

WP SET TEXT