4D v13.4

OBJECT SET STYLED TEXT

ホーム

 
4D v13.4
OBJECT SET STYLED TEXT

OBJECT SET STYLED TEXT 


 

OBJECT SET STYLED TEXT ( {* ;} object ; newText {; startSel {; endSel}} ) 
引数   説明
演算子 in 指定時: objectはオブジェクト名 (文字) 省略時: objectは変数またはフィールド
object  フォームオブジェクト in オブジェクト名 (* 指定時) または フィールドまたは変数 (* 省略時)
newText  テキスト in 挿入するテキスト
startSel  倍長整数 in テキスト選択開始位置
endSel  倍長整数 in テキスト選択終了位置

説明   

OBJECT SET STYLED TEXT コマンドはobject引数で指定されたスタイル付きのフィールドや変数に、 newText引数で渡されたテキストを挿入します。 このコマンドはobject引数のプレーンテキストにのみ適用され、含まれるスタイルタグは更新しません。このコマンドはスクリーンに表示されているスタ イル付きテキストをプログラムで変更するために使用できます。

 

オプションの * 引数を渡した場合、object引数にはオブジェクト名 (文字列) を渡します。コマンド実行時にオブジェクトにフォーカスがある場合、コマンドは編集中のオブジェクトにのみ適用され、(フィールドや変数などの) データソースには適用されません。変更がソース (およびこの同じソースを使用する他のオブジェクト) に転送されるのは、フォーカスが外れるかEnterキーが押されて、オブジェクトへの編集が有効化された場合のみです。オブジェクトにフォーカスがない場合、コマンドは直接データソースに適用され、変更は即座に同じソースを使用する他のオブジェクトに転送されます。
* 引数を省略した場合、object 引数にはフィールドや変数を指定します。この場合文字列ではなくフィールドまたは変数への参照を渡します。コマンドは直接データソースに適用され、変更は即座に同じソースを使用する他のオブジェクトに転送されます。

 

newTextには挿入するテキストを渡します。OBJECT SET STYLED TEXTコ マンドは<SPAN>型のタグを含むリッチ (マルチスタイル) テキスト挿入するために使用します。他のすべてのケース、特に<や>、&を含むプレーンテキストの場合、[#cmd id="1136"/]コマンドを使用しなければなりません。OBJECT SET STYLED TEXTコマンドに < や >、& を含むプレーンテキストを渡すと、コマンドは何も行いません。これは"a>b"のようなテキストをエンコードしないでリッチテキストに挿入すると、 内部的な<SPAN>タグの解析が妨げられるからです。この場合">"文字は"&gt;"にエンコードされなければな りません。これはOBJECT SET PLAIN TEXTにより自動で行われます (このコマンドの例題参照)。

オプションのstartSelendSel引数を使用して、object中のテキストを選択できます。startSelendSelの値はプレーンテキストの選択に使用され、テキスト中のスタイルタグは無視されます。このコマンドの動作はオプションのstartSelendSel引数に基づき変わります:

  • startSelendSelを省略すると、OBJECT SET STYLED TEXTobjectのすべてのテキストをnewTextで置き換えます。
  • startSelのみを渡した場合、またはstartSelendSelが同じ場合、OBJECT SET STYLED TEXTnewTextテキストをobjectstartSelの位置に挿入します。
  • startSelendSel両方渡した場合、OBJECT SET STYLED TEXTはこれらの引数で指定されたプレーンテキストをnewTextテキストで置き換えます。
  • endSelに0をセットすることで、自動的にテキストの最後を指定(startSelに1をセットすることでテキストの最初を指定)できます。

startSelendSelより大きい場合(endSelが0の場合を除く・上記参照)、テキストは変更されず、OK変数が0に設定されます。

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

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

リッチテキストエリア中でユーザーが選択したテキストを変数の内容で置き換えます。

選択されたテキストは以下の通りです:

フィールドには以下のテキストが格納されています:

以下のコードを実行すると:

 vtempo:="Demonstration"
 GET HIGHLIGHT([Products]Notes;vStart;vEnd)
 OBJECT SET STYLED TEXT([Products]Notes;vtemp;vStart;vEnd)

フィールドの表示およびその内容は以下のようになります:

OBJECT SET PLAIN TEXTコマンドの例題を参照してください

 
プロパティ 

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

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

 
目次

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

 
履歴 

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

 
参照 

OBJECT Get plain text
OBJECT Get styled text
OBJECT SET PLAIN TEXT