テキスト
ピッカーの使用を許可
このプロパティが有効化されていると、OPEN FONT PICKER または OPEN COLOR PICKER を使用してユーザーがフォントピッカー/カラーピッカーを呼び出すことを許可します。 これらのピッカーウィンドウを使用して、ユーザーはフォームオブジェクトのフォントやカラーをクリックによって変更できます。 このプロパティが無効になっていると (デフォルト)、ピッカーを開くコマンドは使用できません。
JSON 文法
| プロパティ | データタイプ | とりうる値 |
|---|---|---|
| allowFontColorPicker | boolean | false (デフォルト), true |
対象オブジェクト
太字
選択テキストの線を太くし、濃く見えるようにします。
このプロパティは OBJECT SET FONT STYLE コマンドによって設定することができます。
これは通常のテキストです。
これは太字のテキストです。
JSON 文法
| プロパティ | データタイプ | とりうる値 |
|---|---|---|
| fontWeight | text | "normal", "bold" |
対象オブジェクト
ボタン - チェックボックス - コンボボックス - ドロップダウンリスト - グループボックス - 階層リスト - 入力 - リストボックス - リストボックス列 - リストボックスフッター - リストボックスヘッダー - ラジオボタン - テキストエリア
イタリック
選択テキストの線を右斜めに傾けます。
このプロパティは OBJECT SET FONT STYLE コマンドによって設定することができます。
これは通常のテキストです。
これはイタリックのテキストです。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| fontStyle | string | "normal", "italic" |
対象オブジェクト
ボタン - チェックボックス - コンボボックス - ドロップダウンリスト - グループボックス - 階層リスト - 入力 - リストボックス - リストボックス列 - リストボックスフッター - リストボックスヘッダー - ラジオボタン - テキストエリア
下線
選択テキストの下に線を引きます。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| textDecoration | string | "normal", "underline" |
対象オブジェクト
ボタン - チェックボックス - コンボボックス - ドロップダウンリスト - グループボックス - 階層リスト - 入力 - リストボックス - リストボックス列 - リストボックスフッター - リストボックスヘッダー - ラジオボタン - テキストエリア
フォント
このプロパティは、オブジェクトで使用される フォントテーマ または フォントファミリー を指定します。
フォントテーマ と フォントファミリー プロパティは、どちらか一方しか指定できません。 フォントテーマは、サイズを含めたフォント属性を定めます。 フォントファミリーの場合は、フォント名・フォントサイズ・フォントカラーをそれぞれ定義することができます。
フォントテーマ
フォントテーマプロパティには、自動スタイルの名前を指定します。 自動スタイルは、オブジェクトに使われるフォントファミリー・フォントサイズ・フォントカラーをシステムパラメーターに応じて動的に定めます。 これらのパラメーターは次に依存します:
- プラットフォーム
- システム言語
- フォームオブジェクトのタイプ
フォントテーマを使うことで、システムの現インターフェース標準に沿うようにタイトルが表示されることが保証されます。 ただし、マシンごとにサイズが変わるかもしれません。
3つのフォントテーマが提供されています:
- normal: フォームエディター内で作成された新規オブジェクトにデフォルトで適用される自動スタイルです。
- main および additional フォントテーマは テキストエリア と 入力 オブジェクトでのみサポートされています。 これらのテーマは、おもにダイアログボックスのデザインを目的に提供されています。 インターフェースウィンドウにおいて main フォントテーマは本文用、additional テーマは詳細情報を追記するためのものです。 下に macOS および Windows にてこれらのフォントテーマを使ったダイアログボックスの例を示します:
フォントテーマはフォントだけでなく、サイズやカラーも定めます。 フォントテーマが定めるプロパティを一つでも編集してしまうと、動的に機能しなくなります。 ただし、一部のカスタムスタイルプロパティ (太字、イタリック、下線) は動作に影響なく適用することができます。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| fontTheme | string | "normal", "main", "additional" |
対象オブジェクト
ボタン - チェックボックス - コンボボックス - ドロップダウンリスト - グループボックス - 階層リスト - 入力 - リストボックス - リストボックス列 - リストボックスフッター - リストボックスヘッダー - ラジオボタン - テキストエリア
フォントファミリー
次の 2種類のフォントファミリーが存在します:
- フォントファミリー: "times", "courier", "arial" などのフォントファミリーの名称。
- 総称ファミリー: "serif", "sans-serif", "cursive", "fantasy", "monospace" などの汎用ファミリーの名称。
このプロパティは OBJECT SET FONT コマンドによって設定することができます。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| fontFamily | string | CSS フォントファミリー名 |
4D では Webセーフ フォントだけを使うことを推奨しています。
対象オブジェクト
ボタン - チェックボックス - コンボボックス - ドロップダウンリスト - グループボックス - 階層リスト - 入力 - リストボックス - リストボックス列 - リストボックスフッター - リストボックスヘッダー - ラジオボタン - テキストエリア
フォントサイズ
このプロパティは フォントテーマ を選択していないときに利用できます。
文字の大きさをポイントで指定します。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| fontSize | integer | フォントサイズ (ポイント単位) 最小値: 0 |
対象オブジェクト
ボタン - チェックボックス - コンボボックス - ドロップダウンリスト - グループボックス - 階層リスト - 入力 - リストボックス - リストボックス列 - リストボックスフッター - リストボックスヘッダー - ラジオボタン - テキストエリア
フォントカラー
文字の色を指定します。
オブジェクトの 境界線スタイル に "標準" または "ドット" を選択している場合、このプロパティはその境界線の色も指定します。
カラーは次の方法で指定できます:
- カラーネーム - 例: "red"
- 16進数値 - 例: "#ff0000"
- RGB値 - 例: "rgb(255,0,0)"
このプロパティは OBJECT SET RGB COLORS コマンドによって設定することができます。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| stroke | string | 任意の css値; "transparent"; "automatic" |
対象オブジェクト
ボタン - チェックボックス - コンボボックス - ドロップダウンリスト - グループボックス - 階層リスト - 入力 - リストボックス - リストボックス列 - リストボックスフッター - リストボックスヘッダー - 進捗インジケーター - ルーラー - ラジオボタン - テキストエリア
フォントカラー式
セレクションおよびコレクション/エンティティセレクション型のリストボックス
リストボックスの各行にカスタマイズしたフォントカラーを適用するために使用します。 RGBカラーを使用しなければなりません。 この点に関する詳細は 4Dランゲージリファレンスマニュアルの OBJECT SET RGB COLORS コマンドの説明を参照してください。
式または変数 (配列を除く) を入力します。 表示される行ごとに式や変数は評価されます。 ここでは SET RGB COLORS テーマの定数を使用することができます。
また、このプロパティは LISTBOX SET PROPERTY コマンドに lk font color expression 定数を指定して設定することもできます。
このプロパティは メタ情報式 を使用しても設定することができます。
以下の例は変数名を使用しています。フォントカラー式 に CompanyColor を入力し、フォームメソッドに以下のコードを書きます:
CompanyColor:=Choose([Companies]ID;Background color;Light shadow color;
Foreground color;Dark shadow color)
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| rowStrokeSource | string | フォントカラー式 |
対象オブジェクト
スタイル式
セレクションおよびコレクション/エンティティセレクション型のリストボックス
リストボックスの各行にカスタマイズされた文字スタイルを適用するために使用します。
式または変数 (配列を除く) を入力します。 式や変数は、表示行ごと (リストボックスのプロパティの場合) または表示セルごと (リストボックス列のプロパティの場合) に評価されます。 ここでは Font Styles テーマの定数を使用することができます。
例:
Choose([Companies]ID;Bold;Plain;Italic;Underline)
また、このプロパティは LISTBOX SET PROPERTY コマンドに lk font style expression 定数を指定して設定することもできます。
このプロパティは メタ情報式 を使用しても設定することができます。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| rowStyleSource | string | 表示される行/セルごとに評価されるスタイル式。 |
対象オブジェクト
横揃え
エリア中のテキストの横位置を指定します。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| textAlign | string | "automatic", "right", "center", "justify", "left" |
対象オブジェクト
グループボックス - リストボックス - リストボックス列 - リストボックスヘッダー - リストボックスフッター - テキストエリア
縦揃え
エリア中のテキストの縦位置を指定します。
デフォルト オプション (JSON値: automatic) の場合は、各列のデータ型に基づき整列方向が決定されます:
- ピクチャーを除き、すべて
下です。 - ピクチャーは
上です。
このプロパティは、OBJECT Get vertical alignment と OBJECT SET VERTICAL ALIGNMENT コマンドを使用して設定することもできます。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| verticalAlign | string | "automatic", "top", "middle", "bottom" |
対象オブジェクト
リストボックス - リストボックス列 - リストボックスフッター - リストボックスヘッダー
メタ情報式
コレクションまたはエンティティセレクション型リストボックス
表示される行ごとに評価される式あるいは変数を指定します。 行テキスト属性全体を定義することができます。 オブジェクト変数、あるいは オブジェクトを返す式 を指定する必要があります。 以下のプロパティがサポートされています:
| プロパティ名 | 型 | 説明 |
|---|---|---|
| stroke | string | フォントカラー。 任意の CSSカラー (例: "#FF00FF"), "automatic", "transparent" |
| fill | string | 背景色。 任意の CSSカラー (例: "#F00FFF"), "automatic", "transparent" |
| fontStyle | string | "normal","italic" |
| fontWeight | string | "normal","bold" |
| textDecoration | string | "normal","underline" |
| unselectable | boolean | 対応する行が選択不可 (つまりハイライトすることができない状態) であることを指定します。 このオプションが有効化されている場合、入力可能エリアは入力可能ではなくなります (ただし "シングルクリック編集" オプションが有効化されている場合を除く)。 チェックボックスやリストといったコントロール類は引き続き稼働します。 この設定はリストボックスの選択モードが "なし" の場合には無視されます。 デフォルト値: false。 |
| disabled | boolean | 対応する行を無効化します。 このオプションが有効化されると、入力可能エリアは入力可能ではなくなります。 テキストや、(チェックボックス、リストなどの) コントロール類は暗くなっているかグレーアウトされます。 デフォルト値: false。 |
cell.<columnName> | object | プロパティを単一のカラムに適用するときに使用します。 <columnName> には、リストボックスカラムのオブジェクト名を渡します。 注: "unselectable" および "disabled" プロパティは行レベルでのみ定義可能です。 "セル" オブジェクトに指定した場合、これらは無視されます。 |
このプロパティで設定されたスタイルは、プロパティリスト内で他のスタイル設定が式により定義されている場合には無視されます (スタイル式、フォントカラー式、背景色式)。
例題
Color プロジェクトメソッドには、以下のコードを書きます:
// Color メソッド
// 特定の行に対してフォントカラーを、そして特定のカラムに対して背景色を設定します:
C_OBJECT($0)
Form.meta:=New object
If(This.ID>5) // ID はコレクションオブジェクト/エンティティの属性です
Form.meta.stroke:="purple"
Form.meta.cell:=New object("Column2";New object("fill";"black"))
Else
Form.meta.stroke:="orange"
End if
$0:=Form.meta
ベストプラクティス: このような場合には最適化のため、フォームメソッド内で meta.cell オブジェクトを作成しておくことが推奨されます。
// フォームメソッド
Case of
:(Form event code=On Load)
Form.colStyle:=New object("Column2";New object("fill";"black"))
End case
Color メソッドには、以下のコードを書きます:
// Color メソッド
...
If(This.ID>5)
Form.meta.stroke:="purple"
Form.meta.cell:=Form.colStyle // より良いパフォーマンスのため、同じオブジェクトを再利用します
...
This コマンドも参照してください。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| metaSource | string | 表示される行/セルごとに評価されるオブジェクト式。 |
対象オブジェクト
マルチスタイル
このプロパティは、選択エリアでスタイルの利用を可能にするかどうかを指定するものです。 プロパティリストでこのオプションがチェックされていると、4D はエリア中の <SPAN> HTMLタグをスタイル属性として解釈します。
デフォルトでは、このオプションは有効化されていません。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| styledText | boolean | true, false |
対象オブジェクト
方向
テキストエリアの角度 (回転) を変更します。 テキストエリアは、90°単位で回転させることができます。 それぞれの回転角度を適用するとき、オブジェクトの左下の角は固定されたままで回転していきます:
| 回転角度 | 戻り値 |
|---|---|
| 0 (デフォルト) |  |
| 90 |  |
| 180 |  |
| 270 |  |
スタティックなテキストエリア のほかに、入力不可 に設定された 入力オブジェクト も回転させることが出来ます。 入力オブジェクトの方向プロパティにて 0°以外のオプションを選んだ場合、 入力可プロパティは (選択されていた場合) 自動的に解除されます。 その際、このオブジェクトは入力順から自動的に除外されます。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| textAngle | number | 0, 90, 180, 270 |
対象オブジェクト
行フォントカラー配列
配列型リストボックス
リストボックスの各行/セルにカスタマイズしたフォントカラーを適用するために使用します。
倍長整数型の配列の名前を入力しなければなりません。 配列のそれぞれの要素はリストボックスの行 (あるいは列のセル) に対応します。つまりこの配列は、各列に関連づけられている配列と同じサイズでなければいけません。 ここでは SET RGB COLORS テーマの定数を使用することができます。 もし上のレベルで定義されている背景色をそのままセルに継承したい場合には、対応する配列の要素に -255 を渡します。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| rowStrokeSource | string | 倍長整数型配列の名前 |
対象オブジェクト
行スタイル配列
配列型リストボックス
リストボックスの各行/セルにカスタマイズされた文字スタイルを適用するために使用します。
倍長整数型の配列の名前を入力しなければなりません。 配列のそれぞれの要素はリストボックスの行 (あるいは列のセル) に対応します。つまりこの配列は、各列に関連づけられている配列と同じサイズでなければいけません。 配列へは、Font Styles テーマの定数を使用することができます (メソッドを使用しての入力も可能)。 定数同士を足し合わせてスタイルを組み合わせることもできます。 もし上のレベルで定義されているスタイルをそのままセルに継承したい場合には、対応する配列の要素に -255 を渡します。
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| rowStyleSource | string | 倍長整数型配列の名前 |
対象オブジェクト
スタイルタグを全て保存
このプロパティは マルチスタイル 入力エリアの場合にのみ提供されます。 このオプションがチェックされている場合には、たとえ変更がおこなわれていなくても、エリアはテキストとともにスタイルタグを格納します。 この場合、タグはデフォルトスタイルが適用されます。 このオプションがチェックされていないと、変更されたスタイルタグのみが格納されます。
たとえば、以下のようにスタイルが変更されたテキストがあります:
このプロパティが無効な場合、エリアは更新されたスタイルのみを格納します。 つまり、格納される内容は以下のようになります:
What a <SPAN STYLE="font-size:13.5pt">beautiful</SPAN> day!
同プロパティが有効な場合には、エリアはすべてのフォーマット情報を格納します。 先頭の汎用タグはデフォルトスタイルを定義し、変更されたスタイルはネストされたタグに書き込まれます。 格納される内容は以下のようになります:
<SPAN STYLE="font-family:'Arial';font-size:9pt;text-align:left;font-weight:normal;font-style:normal;text-decoration:none;color:#000000;background-color:#FFFFFF">What a <SPAN STYLE="font-size:13.5pt">beautiful</SPAN> day!</SPAN>
JSON 文法
| 名称 | データタイプ | とりうる値 |
|---|---|---|
| storeDefaultStyle | boolean | true, false (デフォルト) |