4D v13.4

OBJECT Get styled text

ホーム

 
4D v13.4
OBJECT Get styled text

OBJECT Get styled text 


 

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

説明   

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

 

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

 

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

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

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

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

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

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

 
プロパティ 

プロダクト: 4D
テーマ: オブジェクトプロパティ
番号: 1116

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

 
目次

コマンドリスト (文字順)

 
履歴 

初出: 4D v12
変更: 4D v12.1

 
参照 

OBJECT Get plain text
OBJECT SET STYLED TEXT
TEXT TO ARRAY

 
タグ 

multi-style, multistyle, multi style***