4D v14.3

ST Get text

ホーム

 
4D v14.3
ST Get text

ST Get text 


 

ST Get text ( {* ;} object {; startSel {; endSel}} ) -> 戻り値 
引数   説明
演算子 in 指定時objectはオブジェクト名 (文字列) 省略時 objectは変数またはフィールド
object  フォームオブジェクト in オブジェクト名 (* 指定時)または、テキストフィールドか変数 (* 省略時)
startSel  倍長整数 in 文字選択の開始位置
endSel  倍長整数 in 文字選択の終了位置
戻り値  テキスト in スタイルタグを含むテキスト

説明   

ST Get text コマンドは object 引数で指定されたフィールドや変数中のスタイル付きテキストを返します。

 

オプションの * 引数を渡した場合、object引数にはオブジェクト名 (文字列) を渡します。コマンド実行時にオブジェクトにフォーカスがある場合、コマンドは編集中のオブジェクトに関する情報を返します。他方オブジェクトにフォーカスがない場合、コマンドはオブジェクトのデータソース (フィールドや変数) に関する情報を返します。
* 引数を省略した場合、object 引数にはフィールドや変数を指定します。この場合文字列ではなくフィールドまたは変数への参照を渡します。コマンドはこのフィールドや変数に関する情報を返します。

 

コマンドはテキストに割り当てられたスタイルタグとともにテキストを返します。これは例えばスタイルを保持したままテキストのコピーとペーストを行う場合に使用します。

オプションのstartSelendSel引数を使用して、object中のテキストを選択できます。startSelendSelの値はプレーンテキストの選択に使用され、スタイルタグは無視されます。

  • startSelendSelを省略すると、 ST Get textobjectに含まれるすべてのテキストを返します。
  • startSelendSelを渡すと、ST Get text はこれらの引数により選択されたテキストを返します。

4D では選択範囲を自動的に指定するために startSel 引数と endSel 引数に渡せる規定済み定数を用意しています。これらの定数は "Multistyle Text" テーマ内にあります: 

定数 コメント
ST End highlight 倍長整数 -1001 オブジェクト内のカレントのテキストセレクションの最後の文字を指定します(*)
ST End text 倍長整数 0 オブジェクトに含まれるテキストの最後の文字を指定します。
ST Start highlight 倍長整数 -1000 オブジェクト内のテキストのカレントセレクションの最初の文字をを指定します (*)
ST Start text 倍長整数 1 オブジェクト内に含まれるテキストの最初の文字を指定します。

(*) これらの定数を使用するためには、 object にオブジェクト名を渡す必要があります。フィールドまたは変数への参照を渡した場合、コマンドはオブジェクトの全てのテキストに対して適用されます。

startSelendSel の値が等しい場合、またはstartSelendSelよりも大きい場合、エラーが返されます。

このコマンド実行後、エラーがなければOKシステム変数に1が設定されます。そうでなければ0が設定されます。これは特にスタイルタグが正しく評価できなかった場合に発生します (正しくない、あるいは失われたタグ)。

エラーの場合、変数は変更されません。テキストが評価される際に変数にエラーが発生すると、4Dはテキストをプレーンテキストに変換します。結果、"<"、">"、"&"文字はHTML実体参照に変換されます。

 
プロパティ 

プロダクト: 4D
テーマ: Styled Text
番号: 1116

このコマンドはOKシステム変数を更新します

 
履歴 

New
初出: 4D v12
変更: 4D v12.1
名称変更: 4D v14

 
参照 

ST Get plain text
ST SET TEXT
TEXT TO ARRAY

 
タグ 

multi-style, multistyle, multi style

 
ARTICLE USAGE

ランゲージリファレンス ( 4D v14 R2)
ランゲージリファレンス ( 4D v14 R3)
ランゲージリファレンス ( 4D v14.3)
ランゲージリファレンス ( 4D v14 R4)

Inherited from : OBJECT Get styled text ( 4D v12.4)