スタイル付きテキスト

ST COMPUTE EXPRESSIONS ( * ; object : Text {; startSel : Integer {; endSel : Integer}} ) ST COMPUTE EXPRESSIONS ( object : Variable, Field {; startSel : Integer {; endSel : Integer}} )
ST FREEZE EXPRESSIONS ( * ; object : Text {; startSel : Integer {; endSel : Integer}}{; *} ) ST FREEZE EXPRESSIONS ( object : Variable, Field {; startSel : Integer {; endSel : Integer}}{; *} )
ST GET ATTRIBUTES ( * ; object : Text ; startSel : Integer ; endSel : Integer ; attribName : Integer ; attribValue : Variable {; ...(attribName : Integer ; attribValue : Variable)} ) ST GET ATTRIBUTES ( object : Variable, Field ; startSel : Integer ; endSel : Integer ; attribName : Integer ; attribValue : Variable {; ...(attribName : Integer ; attribValue : Variable)} )
ST Get content type ( * ; object : Text {; startSel : Integer {; endSel : Integer {; startBlock : Integer {; endBlock : Integer}}}} ) : Integer ST Get content type ( object : Variable, Field {; startSel : Integer {; endSel : Integer {; startBlock : Integer {; endBlock : Integer}}}} ) : Integer
ST Get expression ( * ; object : Text {; startSel : Integer {; endSel : Integer}} ) : Text ST Get expression ( object : Variable, Field {; startSel : Integer {; endSel : Integer}} ) : Text
ST GET OPTIONS ( * ; object : Text ; option : Integer ; value : Integer {; ...(option : Integer ; value : Integer)} ) ST GET OPTIONS ( object : Variable, Field ; option : Integer ; value : Integer {; ...(option : Integer ; value : Integer)} )
ST Get plain text ( * ; object : Text {; refMode : Integer} ) : Text ST Get plain text ( object : Variable, Field {; refMode : Integer} ) : Text
ST Get text ( * ; object : Text {; startSel : Integer {; endSel : Integer}} ) : Text ST Get text ( object : Variable, Field {; startSel : Integer {; endSel : Integer}} ) : Text
ST GET URL ( * ; object : Text ; urlText : Text ; urlAddress : Text {; startSel : Integer {; endSel : Integer}} ) ST GET URL ( object : Variable, Field ; urlText : Text ; urlAddress : Text {; startSel : Integer {; endSel : Integer}} )
ST INSERT EXPRESSION ( {* ;} object : Object ; expression : Text {; startSel : Integer {; endSel : Integer}} )
ST INSERT URL ( * ; object : Text ; urlText : Text ; urlAddress : Text {; startSel : Integer {; endSel : Integer}} ) ST INSERT URL ( object : Variable, Field ; urlText : Text ; urlAddress : Text {; startSel : Integer {; endSel : Integer}} )
ST SET ATTRIBUTES ( * ; object : Text ; startSel : Integer ; endSel : Integer ; attribName : Integer ; attribValue : Text, Integer {; ...(attribName : Integer ; attribValue : Text, Integer)} ) ST SET ATTRIBUTES ( object : Variable, Field ; startSel : Integer ; endSel : Integer ; attribName : Integer ; attribValue : Text, Integer {; ...(attribName : Integer ; attribValue : Text, Integer)} )
ST SET OPTIONS ( * ; object : Text ; option : Integer ; value : Integer {; ...(option : Integer ; value : Integer)} ) ST SET OPTIONS ( object : Variable, Field ; option : Integer ; value : Integer {; ...(option : Integer ; value : Integer)} )
ST SET PLAIN TEXT ( * ; object : Text ; newText : Text {; startSel : Integer {; endSel : Integer}} ) ST SET PLAIN TEXT ( object : Variable, Field ; newText : Text {; startSel : Integer {; endSel : Integer}} )
ST SET TEXT ( * ; object : Text ; newText : Text {; startSel : Integer {; endSel : Integer}} ) ST SET TEXT ( object : Variable, Field ; newText : Text {; startSel : Integer {; endSel : Integer}} )

テキスト管理コマンドの使い方

ユーザーインターフェース

テキストオブジェクトをプログラミングで操作するために使用されるコマンドは、テキストに埋め込まれたスタイルタグを考慮しません。 これらは表示されるテキストに対してのみ動作します。 これは以下のコマンドに対して関係します:

• ユーザーインターフェース テーマコマンド
• HIGHLIGHT TEXT
• GET HIGHLIGHT

これらのコマンドを文字列を操作するコマンドと組み合わせて使用した場合、ST Get plain text コマンドを使用して書式設定文字列を除去する必要があります:

 HIGHLIGHT TEXT([Products]Notes;1;Length(ST Get plain text([Products]Notes))+1)

オブジェクト (フォーム)

オブジェクトのスタイルを変更するのに使用されるコマンド(OBJECT SET FONT など)は選択範囲ではなく、オブジェクト全体に対して適用されます。

コマンドが実行された時にオブジェクトにフォーカスが入っていなければ、その変更はオブジェクト(テキストエリア)とそれに割り当てられた変数の両方に同時に適用されます。 オブジェクトにフォーカスが入っている場合、変更はオブジェクトに対しては適用されますが、割り当てられた変数には適用されません。 その後、オブジェクトがフォーカスを失ったとき、変数に対しても変更が適用されます。 テキストエリアに対するプログラムを行う際は、この原則を忘れないでください。

注

デフォルトスタイルタグを格納 がオブジェクトに対して選択されている場合にこれらのコマンドを使用すると、オブジェクトに保存されているタグが更新されます。

またデフォルトのプロパティもこれらのコマンドの影響を受けるという点に注意してください(またデフォルトタグによって保存されたあらゆるプロパティも同様です)。 カスタムのスタイルタグはそのままの状態を維持します。 例えば、以下の様なマルチスタイルエリアにデフォルトのタグが保存されていた場合を考えます:

このエリアのプレーンテキストは以下のようになります:

<span style="text-align:left;font-family:'Segoe UI';font-size:9pt;color:#009900">This is the word <span style="color:#D81E05">red</span></span>

以下のコードを実行した場合:

OBJECT SET COLOR(*;"myArea";-(Blue+(256*Yellow)))

赤の文字カラーはそのまま残ります:

コードは以下の様になります:

<span style="text-align:left;font-family:'Segoe UI';font-size:9pt;color:#0000FF">This is the word <span style="color:#D81E05">red</span></span>

これには以下のコマンドが適用されます:

• OBJECT SET RGB COLORS
• OBJECT SET FONT
• OBJECT SET FONT STYLE
• OBJECT SET FONT SIZE

マルチスタイルエリアのコンテキストにおいては、これらのコマンドはデフォルトのスタイルを設定するためだけに使用されるべきです。 データベースの実行中にスタイルを管理するためには、"スタイル付きテキスト" テーマ内のコマンドを使用することが推奨されます。

Get edited text

Get edited text コマンドがリッチテキストエリアで使用されると、コマンドはあらゆるスタイルタグを含む現在のエリアのテキストを返します。

編集されている"生の"テキスト(タグなしのテキスト) を取り出すには、ST Get plain text コマンドを使用しなければなりません:

ST Get plain text(Get edited text)

クエリおよび並び替えコマンド

マルチスタイルオブジェクトに対して行われるクエリや並び替えは、オブジェクトに保存されたスタイルタグを考慮に入れます。 単語中でスタイルの変更が行われた場合、その単語の検索は失敗します。

有効な検索や並び替えを行うには、ST Get plain text コマンドを使用します。 例:

QUERY BY FORMULA([MyTable];ST Get plain text([MyTable]MyFieldStyle)="very well")