背景色と境界線

交互に使用する背景色

奇数番の行/列に使用するための異なる背景色を設定することができます。デフォルトでは、自動 が選択されており、リストボックスレベルで設定されている "交互に使用する背景色" を列も使用します。

このプロパティはOBJECT SET RGB COLORS コマンドを使用しても設定することができます。

JSON 文法

名称	データタイプ	とりうる値
alternateFill	string	任意の CSS値; "transparent"; "automatic"; "automaticAlternate"

対象オブジェクト

リストボックス - リストボックスカラム

コマンド

OBJECT GET RGB COLORS - OBJECT SET RGB COLORS

---

背景色/塗りカラー

オブジェクトの背景色/塗りカラーを設定します。一部の標準のオブジェクト(fill JSON プロパティを使用) あるいは"カスタムスタイル" オブジェクト (borderFillColor JSON プロパティを使用) に対して定義することが可能です。

注

塗りカラー プロパティはリストボックス、リストボックスカラム およびList Box Footer オブジェクトでは背景色 という名前になっています。

標準のオブジェクト

リストボックスの場合にはデフォルトで、自動 が選択されており、リストボックスレベルで設定されている背景色を列も使用します。

JSON 文法

名称	データタイプ	とりうる値
fill	string	任意の css値; "transparent"; "automatic"

対象オブジェクト

階層リスト - リストボックス - リストボックスカラム - リストボックスフッター - 楕円 - 四角 - テキストエリア

コマンド

LISTBOX Get row color - LISTBOX SET ROW COLOR - OBJECT GET RGB COLORS - OBJECT SET RGB COLORS

カスタムボタン、カスタムチェックボックス、あるいはカスタムのラジオボタン

このプロパティを使用することで、カスタムボタン 、カスタムのチェックボックス 、あるいはカスタムのラジオボタン に対して塗りカラー属性を割り当てることができます。さらに、カスタムボタン の場合には、"カスタム" 境界線スタイル になっている必要があります。その他のコンテキストにおいては、このプロパティは無視されます。

JSON 文法

名称	データタイプ	とりうる値
borderFillColor	string	任意の css値; "transparent"; "automatic"

対象オブジェクト

カスタムボタン("カスタム" の境界線スタイル のもの) - カスタムチェックボックス - カスタムラジオボタン

コマンド

OBJECT GET RGB COLORS - OBJECT SET RGB COLORS

参照

透過

---

背景色式

セレクションとコレクション型リストボックス

リストボックスの各行にカスタムの背景色を指定するための式または変数 (配列変数は使用不可)。式または変数は表示行ごとに評価され、RGB値を返さなくてはなりません。詳細については、OBJECT SET RGB COLORS コマンドの詳細を参照してください。

また、このプロパティは LISTBOX SET PROPERTY コマンドに lk background color expression 定数を指定して設定することもできます。

コレクション/エンティティセレクション型リストボックスでは、このプロパティは メタ情報式 を使用しても設定することができます。

JSON 文法

名称	データタイプ	とりうる値
rowFillSource	string	RGBカラー値を返す式

対象オブジェクト

リストボックス - リストボックスカラム

コマンド

LISTBOX Get property - LISTBOX SET PROPERTY

---

境界線カラー

以下のオブジェクトに対して、内側の境界線のカラーを定義します:

• "カスタム" 境界線スタイル を持ったカスタムボタン
• カスタムチェックボックス
• カスタムラジオボタン

その他のコンテキストにおいては、このプロパティは無視されます。

境界線は、幅 が> 0 (0 より大きい)の場合にのみ表示されるという点に注意して下さい。

JSON 文法

名称	データタイプ	とりうる値
borderColor	string	任意の css値; "transparent"; "automatic"

対象オブジェクト

カスタムボタン("カスタム" の境界線スタイル のもの) - カスタムチェックボックス - カスタムラジオボタン

コマンド

OBJECT GET RGB COLORS - OBJECT SET RGB COLORS

境界線スタイル

リストボックスの境界線のスタイルを設定します。

注

カスタムボタン においては、カスタム の境界線スタイルを使用すると内部フレームデザインが有効化され、これによって以下のプロパティのセットが追加されます: 塗りカラー、フレームカラー、フレーム幅、および角の半径。

関連したblog 記事

Customize Buttons, Radio Buttons, and Check Boxes with Background and Border Properties.

JSON 文法

名称	データタイプ	とりうる値
borderStyle	text	"system", "none", "solid", "dotted", "raised", "sunken", "double", "custom"

対象オブジェクト

4D View Pro エリア - 4D Write Pro エリア - ボタン - ボタングリッド - 階層リスト - 入力 - リストボックス - ピクチャーボタン - ピクチャーポップアップメニュー - プラグインエリア - 進捗インジケーター - ルーラー - スピナー - ステッパー - サブフォーム - テキストエリア - Web エリア

コマンド

OBJECT Get border style - OBJECT SET BORDER STYLE

---

境界線幅

以下のオブジェクトに対して、内側の境界線の幅を定義します:

• "カスタム" 境界線スタイル を持ったカスタムボタン
• カスタムチェックボックス
• カスタムラジオボタン

その他のコンテキストにおいては、このプロパティは無視されます。

値はピクセル単位で指定しなければなりません。

JSON 文法

名称	データタイプ	とりうる値
borderWidth	number	整数値(ピクセル)。最小値 = 0

対象オブジェクト

カスタムボタン("カスタム" の境界線スタイル のもの) - カスタムチェックボックス - カスタムラジオボタン

---

角の半径

履歴

リリース	内容
21 R5	カスタムスタイルのボタン、ラジオボタン、チェックボックスのサポート
19 R7	テキストと入力オブジェクトをサポート

フォームオブジェクトの角の丸みをピクセル単位で指定します。デフォルトでは、角の半径は 0ピクセルとなっています。このプロパティを変更することによって独自の形の角の丸いフォームオブジェクトを描画することができます:

最小値は 0 で、この場合には標準の (角の丸くない) フォームオブジェクトが描画されます。最大値は四角のサイズに応じて変化し、動的に計算されます (ただし四角の短辺の半分を超えることはできません)。

テキストエリア および入力 では以下のように振る舞います:

• 角の半径プロパティは、境界線スタイルが "なし"、"標準"、"ドット" の場合にのみ利用可能です
• 角の丸みはフォームオブジェクトの外側に描画されます (つまり、オブジェクトはより大きく表示されますが、幅 と 高さ プロパティは変更されません)。

カスタムボタン ("カスタム" 境界線スタイルを使用)、 カスタムチェックボックス およびカスタムラジオボタン においては、角の丸みはオブジェクトのエリアの内側に描画されます。

JSON 文法

名称	データタイプ	とりうる値
borderRadius	integer	最小値: 0

対象オブジェクト

カスタムボタン ("カスタム" 境界線スタイルを使用しているもの) - カスタムチェックボックス - 入力 - 四角形 - テキストエリア - カスタムラジオボタン

コマンド

OBJECT GET CORNER RADIUS - OBJECT SET CORNER RADIUS

---

点線タイプ

点線のタイプを、点と白のパターンにより指定します。

JSON 文法

名称	データタイプ	とりうる値
strokeDashArray	数値配列または文字列	例: 例: 6個の点と1個の空白のパターンは "6 1" または [6,1] によって表します。

対象オブジェクト

四角 - 楕円 - 線

---

追加の空白の行を非表示

リストボックスオブジェクト下部に追加される余分な空白行の表示を管理します。デフォルトで、4D は空のエリアを埋めるためにこのような行を追加します:

このオプションをチェックすると、これらの空白行を除去することができます。リストボックスオブジェクトの下部は空のままになります:

JSON 文法

名称	データタイプ	とりうる値
hideExtraBlankRows	boolean	true, false

対象オブジェクト

リストボックス

コマンド

LISTBOX Get property - LISTBOX SET PROPERTY

---

線カラー

オブジェクトの線の色を指定します。カラーは次の方法で指定できます:

• カラーネーム - 例: "red"
• 16進数値 - 例: "#ff0000"
• RGB値 - 例: "rgb(255,0,0)"

このプロパティはOBJECT SET RGB COLORS コマンドを使用しても設定することができます。

JSON 文法

名称	データタイプ	とりうる値
stroke	string	任意の css値; "transparent"; "automatic"

このプロパティはテキスト系のオブジェクトでも利用可能です。この場合、このプロパティはフォントカラーおよびオブジェクトの線カラーの両方を指定します (フォントカラー 参照)。

対象オブジェクト

線 - 楕円 - 四角

コマンド

OBJECT GET RGB COLORS - OBJECT SET RGB COLORS

---

線幅

線の幅を指定します。

JSON 文法

名称	データタイプ	とりうる値
strokeWidth	number	印刷されるフォームにおける最小幅 0 から、整数値 < 20 まで

対象オブジェクト

線 - 楕円 - 四角

---

行背景色配列

配列型リストボックス

リストボックスまたはリストボックス列の各行にカスタムの背景色を適用するのに使用する配列名です。

倍長整数型の配列の名前を入力しなければなりません。配列のそれぞれの要素はリストボックスの行 (あるいは列のセル) に対応します。 つまりこの配列は、各列に関連づけられている配列と同じサイズでなければいけません。 OBJECT SET RGB COLORS コマンドの章で説明されている定数を使用することができます。もし上のレベルで定義されている背景色をそのままセルに継承したい場合には、対応する配列の要素に -255 を渡します。

たとえば、リストボックスプロパティにてグレー/ライトグレーカラーが行の交互背景色として設定されているとします。同じリストボックスに行背景色配列が指定されており、行内で負の値が一つでもあれば色をオレンジに変えます:

 <>_BgndColors{$i}:=0x00FFD0B0 // オレンジ
 <>_BgndColors{$i}:=-255 // デフォルト値

次に、負の値を持つセルの色を濃いオレンジで示したい場合、各列にも行背景色配列を設定します (例: <>_BgndColor_1, <>_BgndColor_2 と <>_BgndColor_3)。これらの配列の値は、リストボックスプロパティに設定されているものや、全体用の行背景色配列よりも優先されます。

 <>_BgndColorsCol_3{2}:=0x00FF8000 // 濃いオレンジ
 <>_BgndColorsCol_2{5}:=0x00FF8000
 <>_BgndColorsCol_1{9}:=0x00FF8000
 <>_BgndColorsCol_1{16}:=0x00FF8000

LISTBOX SET ROW FONT STYLE および LISTBOX SET ROW COLOR コマンドを使用することでも同じ結果を得ることができます。コマンドを使う利点は、スタイル/カラー配列をあらかじめ列に設定する必要がないことです。 この場合、これらはコマンドによって動的に作成されます。

JSON 文法

名称	データタイプ	とりうる値
rowFillSource	string	倍長整数型配列の名前

対象オブジェクト

リストボックス - リストボックスカラム

コマンド

LISTBOX Get array - LISTBOX GET ARRAYS

---

透過

リストボックスの背景を透明にします。このプロパティが有効になっていると、列に対して設定されている 交互に使用する背景色 および 背景色 の設定は無視されます。

JSON 文法

名称	データタイプ	とりうる値
fill	text	"transparent"

対象オブジェクト

リストボックス

コマンド

OBJECT GET RGB COLORS - OBJECT SET RGB COLORS

参照

背景色/塗りカラー