4D Doc Center : OBJECT SET STYLED TEXT

4D v12.4

OBJECT SET STYLED TEXT


OBJECT SET STYLED TEXT ( {* ;} object ; newText {; startSel {; endSel}} )

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

説明

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

オプションの * 引数を渡すと、object引数はオブジェクト名 (文字) です。この引数を渡さないと、objectはフィールドまたは変数です。この場合、文字ではなくフィールドまたは変数への参照を渡します。

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

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

startSelとendSelを省略すると、OBJECT SET STYLED TEXTはobjectのすべてのテキストをnewTextで置き換えます。
startSelのみを渡した場合、またはstartSelとendSelが同じ場合、OBJECT SET STYLED TEXTはnewTextテキストをobjectのstartSelの位置に挿入します。
startSelとendSel両方渡した場合、OBJECT SET STYLED TEXTはこれらの引数で指定されたプレーンテキストをnewTextテキストで置き換えます。

startSelがendSelより大きい場合、テキストは変更されず、OK変数が0に設定されます。

例題 1

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

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

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

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

 vtempo:="Demonstration"

 GET HIGHLIGHT([Products]Notes;vStart;vEnd)

 OBJECT SET STYLED TEXT([Products]Notes;vtemp;vStart;vEnd)

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

例題 2

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

システム変数およびセット

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

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