バージョン: 20 R5 BETA

オブジェクト

タイプ

MANDATORY SETTING

このプロパティはアクティブまたはスタティックなフォームオブジェクトのタイプを指定します。

JSON 文法

名称	データタイプ	とりうる値
type	string	"button", "buttonGrid", "checkbox", "combo", "dropdown", "groupBox", "input", "line", "list", "listbox", "oval", "picture", "pictureButton", "picturePopup", "plugin", "progress", "radio", "rectangle", "ruler", "spinner", "splitter", "stepper", "subform", "tab", "text", "view", "webArea", "write"

対象オブジェクト

4D View Pro area - 4D Write Pro area - Button - Button Grid - Check Box - Combo Box - Drop-down List - Group Box - Hierarchical List - List Box - List Box Column - List Box Footer - List Box Header - Picture Button - Picture Pop-up Menu - Plug-in Area - Progress indicator - Radio Button -Spinner - Splitter - Static Picture - Stepper - Subform - Tab control - Text Area - Web Area

オブジェクト名

各アクティブフォームオブジェクトにはオブジェクト名が関連付けられています。各オブジェクト名はユニークでなければなりません。

オブジェクト名のサイズ上限は 255バイトです。

When using 4D’s language, you can refer to an active form object by its object name (for more information about this, refer to Object Properties in the 4D Language Reference manual).

フォームオブジェクトの命名規則については識別子の章を参照してください。

JSON 文法

名称	データタイプ	とりうる値
name	string	既存オブジェクトによって使用されていない、命名規則に沿った名称

対象オブジェクト

4D View Pro area - 4D Write Pro area - Button - Button Grid - Check Box - Combo Box - Drop-down List - Group Box - Hierarchical List - List Box - List Box Column - List Box Footer - List Box Header - Picture Button - Picture Pop-up Menu - Plug-in Area - Progress indicator - Spinner - Splitter - Static Picture - Stepper - Radio Button - Subform - Tab control - Text Area - Web Area

値を記憶

このオプションは、フォームの配置を記憶プロパティがチェックされている場合に利用可能です。

この機能は、フォームの全体的な配置に関係するオブジェクトに対してのみサポートされています。たとえばチェックボックスは、ウィンドウ内の追加エリアを表示/非表示するのに使用することができるため、このオプションが存在します。

「値」を保存できるオブジェクトは以下のとおりです:

Object	保存される値
Check Box	関連付けられた変数の値 (0, 1, 2)
Drop-down List	選択されている項目の番号
Radio Button	関連付けられた変数の値 (1、0、ボタンにおいては true/false など型による)
Tab control	選択されているタブの番号

JSON 文法

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

対象オブジェクト

チェックボックス* ドロップダウンリスト

変数あるいは式

セレクションおよびコレクション型のリストボックス列に関しては式の章も参照ください。

このプロパティは、データのソースを指定します。各アクティブフォームオブジェクトにはオブジェクト名と変数名が関連付けられています。変数名とオブジェクト名は違っていてもかまいません。同じフォーム内で複数のアクティブオブジェクトに同じ変数名を割り当てることができますが、オブジェクト名はそれぞれユニークでなければなりません。

変数名の上限は 31バイトです。命名規則については識別子の章を参照してください。

フォームオブジェクト変数を使って、オブジェクトを監視・コントロールすることができます。たとえば、ボタンがクリックされると、その変数の値は 1 に設定されます。それ以外の場合は 0 です。進捗インジケーターに関連づけられた式は、現設定の取得・変更を可能にします。

代入可・代入不可の変数および式が使用でき、取得できるデータ型はテキスト、整数、数値、日付、時間、ピクチャー、ブール、そしてオブジェクトです。

JSON 文法

名称	データタイプ	とりうる値
dataSource	string、または sting のコレクション	4D variable, field name, or any expression. Empty string for dynamic variables. String array (collection of array names) for a hierarchical listbox column]

式

オブジェクトのデータソースとして、式を使用することができます。シンプルな式、オブジェクトプロパティ、フォーミュラ、4D関数、プロジェクトメソッド名、標準の [Table]Field シンタックスを使用したフィールド名を使用できます。式はフォームが実行されたときに評価され、フォームイベント毎に再評価されます。式には、代入可および代入不可の式があることに注意が必要です。

入力された式が、変数名とメソッド名の両方で使用されている場合、4Dはメソッド名が指定されたものと判断します。

ダイナミック変数

You can leave it up to 4D to create variables associated with your form objects (buttons, enterable variables, check boxes, etc.) dynamically and according to your needs. これをおこなうには、"変あるいは式" プロパティを空にします (あるいは JSON の dataSource フィールド):

変数名が与えられていない場合、4D はフォームがロードされたときにインタープリターのプロセス変数の空間内でユニークな名前を計算し、その名前でオブジェクト用の変数を新規作成します (このメカニズムはコンパイルモードでも使用することができます)。この一時的な変数はフォームが閉じられるときに破棄されます。この方式をコンパイルモードで動作させるためには、ダイナミック変数の型を明示的に指定しなければなりません。これをおこなうには 2つの方法があります:

プロパティリストの式タイプを使用して型を指定する。
たとえば VARIABLE TO VARIABLE コマンドを使用する、専用の初期化コードをフォームロード時に実行する。

 If(Form event code=On Load)
    var $init : Text
    $Ptr_object:=OBJECT Get pointer(Object named;"comments")
    $init:=""
    VARIABLE TO VARIABLE(Current process;$Ptr_object->;$init)
 End if

4Dコード中では、 OBJECT Get pointer コマンドで取得できるポインターを介してダイナミック変数にアクセスできます。例:

  // assign the time 12:00:00 to the variable for the "tstart" object
 $p :=OBJECT Get pointer(Object named;"tstart")
 $p->:=?12:00:00?

このメカニズムを使用する利点は 2つあります:

ひとつのホストフォーム上で複数個配置することの可能な "サブフォーム" タイプのコンポーネント開発を可能にします。たとえば、開始日と終了日を設定する 2つの日付ピッカーサブフォームをホストフォーム上に配置するケースを考えてみましょう。このサブフォームでは、日付を選択するためのオブジェクトが使用されます。開始日と終了日をそれぞれ選択できるよう、これらオブジェクトにはそれぞれ別の変数が割り当てられている必要があります。 4Dにダイナミック変数を生成させることでユニークな変数を得ることができ、この問題を解決できます。
また、メモリの利用を減少させることができます。フォームオブジェクトでは、プロセス変数とインタープロセス変数しか使用できません。しかしコンパイルモードでは、各プロセス変数のインスタンスが (サーバープロセスを含め) すべてのプロセスに対して作成されます。このインスタンスは、セッション中にフォームが使用されない場合でもメモリを消費します。フォームのロード時、4Dにダイナミック変数を作成させることで、メモリを節約できます。

配列リストボックス

配列型リストボックスの場合、リストボックスおよびリストボックス各列の 変数あるいは式 プロパティには、それぞれに関連付ける配列変数の名前を指定します。ただし、リストボックスの JSON定義においては、列の dataSource 値として、配列名 (文字列) のコレクションを指定すると階層リストボックスが定義されます。

対象オブジェクト

4D View Pro area - 4D Write Pro area - Button - Button Grid - Check Box - Combo Box - Drop-down List - Hierarchical List - List Box - List Box Column - List Box Header - List Box Footer - Picture Pop-up Menu - Plug-in Area - Progress indicator - Radio Button - Spinner - Splitter - Stepper - Subform - Tab control - Web Area

式の型/式タイプ

This property is called Data Type in the Property List for selection and collection type list box columns and for Drop-down Lists associated to an object or an array.

オブジェクトに関連付けられた式または変数のデータ型を指定します。この設定の主な目的は、プロパティリスト内で提供されるテーマとオプションが、データの型と対応するようにするためです。つまり、実際に変数の型そのものを決めるわけではありません。プロジェクトをコンパイルするには、変数を宣言する必要があります。

ただし、次の特定の場合には、このプロパティは型宣言の機能を持ちえます:

ダイナミック変数: このプロパティを使って、ダイナミック変数の型を宣言することができます。
リストボックス列: このプロパティは列データに表示フォーマットを関連づけるのに使用されます。提供されるフォーマットは変数型 (配列型のリストボックス) またはデータ/フィールド型 (セレクションおよびコレクション型のリストボックス) により異なります。使用できる標準の 4D フォーマットはテキスト、数値、整数、日付、時間、ピクチャー、そしてブールです。テキストの場合は専用の表示フォーマットがありません。標準フォーマットのほかに、定義したカスタムフォーマットも選択することができます。
ピクチャー変数: このプロパティを使うと、インタープリタモードにおいてフォームロード前に変数を宣言することができます。フォーム上のピクチャー変数にピクチャーを表示する際には特別なメカニズムが使用されます。そのため、他の型の変数とは違って、ピクチャー変数の宣言は、フォームロード前 (On Load フォームイベントよりも先) におこなう必要があります。 To do this, you need either for the statement C_PICTURE(varName) to have been executed before loading the form (typically, in the method calling the DIALOG command), or for the variable to have been typed at the form level using the expression type property. このいずれかをおこなわない場合、ピクチャー変数はピクチャーを正しく表示できません (インタープリターモードのみ)。

JSON 文法

名称	データタイプ	とりうる値
dataSourceTypeHint	string	standard objects: "integer", "boolean", "number", "picture", "text", date", "time", "arrayText", "arrayDate", "arrayTime", "arrayNumber", "collection", "object", "undefined" list box columns: "boolean", "number", "picture", "text", date", "time". Array/selection list box only: "integer", "object"

対象オブジェクト

Check Box - Combo Box - Drop-down List - Input - List Box Column - List Box Footer - Plug-in Area - Progress indicator - Radio Button - Ruler - Spinner - Stepper - Subform - Tab Control

CSSクラス

cssファイルにてクラスセレクターとして使用される、(複数の場合は半角スペース区切りの) クラス名のリスト。

JSON 文法

名称	データタイプ	とりうる値
class	string	(複数の場合は半角スペース区切りの) クラス名の文字列

対象オブジェクト

4D View Pro area - 4D Write Pro area - Button - Button Grid - Check Box - Combo Box - Drop-down List - Group Box - Hierarchical List - List Box - Picture Button - Picture Pop-up Menu - Plug-in Area - Radio Button - Static Picture - Subform - Text Area - Web Area

コレクションまたはエンティティセレクション

コレクション要素あるいはエンティティを使用して、リストボックスの行の中身を定義することができます。

コレクションあるいはエンティティセレクションを返す式を入力します。一般的には、コレクションまたはエンティティセレクションを格納している変数名、コレクション要素、あるいはプロパティを入力します。

コレクションおよびエンティティセレクションは、フォームロード時にフォームから利用可能でなければなりません。コレクションの各要素、あるいはエンティティセレクションの各エンティティは、リストボックスの行へと割り当てられ、This キーワードを通してオブジェクトとして利用可能です:

オブジェクトのコレクションを使用した場合、データソース式内で This コマンドを呼び出すことで、各プロパティ値にアクセスすることが可能です。例: This.<propertyPath>。
エンティティセレクションを使用した場合、データソース式内で This コマンドを呼び出すことで、各属性値へとアクセスすることが可能です。例: This.<attributePath>。

(オブジェクトでない) スカラー値のコレクションを使用した場合、データソース式内で This.value を呼び出すことで、各値にアクセスすることが可能です。ただしこの場合、値の変更や現在のオブジェクトへのアクセスはできません。

JSON 文法

名称	データタイプ	とりうる値
dataSource	string	コレクションあるいはエンティティセレクションを返す式

対象オブジェクト

List Box

データソース

リストボックスの種類を指定します。

配列 (デフォルト): リストボックスの各行に配列要素を割り当てます。
カレントセレクション: 指定したテーブルのカレントセレクションの各レコードごとに式、フィールド、メソッドが評価されます。
命名セレクション: 指定した命名セレクションに含まれる各レコードごとに式、フィールド、メソッドが評価されます。
コレクションまたはエンティティセレクション: コレクション要素あるいはエンティティを使用してリストボックスの行の中身を定義します。この場合コレクションまたはエンティティセレクションプロパティを定義する必要があります。

JSON 文法

名称	データタイプ	とりうる値
listboxType	string	"array", "currentSelection", "namedSelection", "collection"

対象オブジェクト

List Box

プラグインの種類

オブジェクトに関連付けるプラグインが提供する外部エリアの名称。ここで指定する名称は、プラグインの manifest.json ファイルにて公開されています。

JSON 文法

名称	データタイプ	とりうる値
pluginAreaKind	string	プラグインが提供する外部エリアの、% 文字で始まる名称 (プロパティリストの候補表示では、この % 文字は表示されません)

対象オブジェクト

Plug-in Area

ラジオグループ

複数のラジオボタンを連動させるためのプロパティです。同じラジオグループに属している複数のラジオボタンは、一度にその内の一つのみを選択することができます。

JSON 文法

名称	データタイプ	とりうる値
radioGroup	string	ラジオグループ名

対象オブジェクト

Radio Button

タイトル

オブジェクトにラベルを追加します。このラベルのフォントとスタイルは指定することができます。

\文字 (バックスラッシュまたは円マーク) を使用すると、ラベル内で強制的に改行することができます。

ラベルに \ を表示したい場合は \ と入力します。

デフォルトでラベルはオブジェクトの中央に置かれます。またオブジェクトにアイコンも含まれている場合、タイトル/ピクチャー位置プロパティを用いて、これら2 つの要素の相対位置を変更することができます。

インターフェースの翻訳の目的で、XLIFF 参照をボタンのタイトルエリアに入力することができます (付録 B: XLIFFアーキテクチャー参照)。

JSON 文法

名称	データタイプ	とりうる値
text	string	なんらかのテキスト

対象オブジェクト

ボタン - チェックボックス - リストボックスヘッダー - ラジオボタン - テキストエリア

変数の計算

このプロパティは、リストボックスフッターエリアに適用される計算タイプを設定します。

リストボックスのフッターに割り当てる自動計算は LISTBOX SET FOOTER CALCULATION 4Dコマンドを使用しても設定できます。

様々な自動計算が利用可能です。以下の表は、列のデータ型に応じて使用することのできる計算と、(コードで明示的に宣言されていないとき) 4D によってフッター変数に自動で割り当てられる型を示しています:

計算タイプ	Num	Text	日付	時間	Bool	ピクチャー	フッター変数の型
最小	X	X	X	X	X		列の型と同じ
最大	X	X	X	X	X		列の型と同じ
合計	X			X	X		列の型と同じ
カウント	X	X	X	X	X	X	Longint
平均	X			X			Real
標準偏差(*)	X			X			Real
分散(*)	X			X			Real
平方和(*)	X			X			Real
カスタム (JSON では "none")	X	X	X	X	X	X	制限なし

(*) 配列型のリストボックスのみ

フッター計算には、宣言された、あるいは動的な変数のみを使用できます。その他の式 (例: Form.value) はサポートされていません。

自動計算の際、リストボックス行の表示/非表示状態は考慮されません。表示行だけを計算対象にしたい場合、カスタムを選択してプログラムコードで計算しなくてはなりません。

Null 値は計算において無視されます。

異なる型の値がカラムに含まれる場合 (コレクションに基づいている場合など):

平均と合計は数値のみを計算に含めます (他の型の値は無視されます)。
最小と最大は、collection.sort() 関数にて定義されるのと同じ最小値と最大値を返します。

式に基づいている列のフッターにおいて自動計算を使用するにあたっては、次の制限があります:

式が "単純" なものの場合 ([table]field や this.attribute など) には、すべてのリストボックスタイプで サポートされます
式が "複雑" (つまり、this.attribute 以外) で、かつリストボックスの行数が多い場合には、コレクション/エンティティセレクションリストボックスにおいて サポートはされるものの、パフォーマンス上の理由により 推奨されません。
式が "複雑" な場合には、カレントセレクション/命名セレクションリストボックスにおいて サポートされません。これらの場合には、カスタム計算を使用する必要があります。

カスタム (JSON では "none") を選択した場合、4D は自動計算をおこないません。プログラムを使用して表示する値をエリアの変数に代入しなければなりません。

JSON 文法

名称	データタイプ	とりうる値
variableCalculation	string	"none", "minimum", "maximum", "sum", "count", "average", "standardDeviation", "variance", "sumSquare"

対象オブジェクト

List Box Footer

タイプ​

JSON 文法​

対象オブジェクト​

オブジェクト名​

JSON 文法​

対象オブジェクト​

値を記憶​

JSON 文法​

対象オブジェクト​

変数あるいは式​

JSON 文法​

式​

ダイナミック変数​

配列リストボックス​

対象オブジェクト​

式の型/式タイプ​

JSON 文法​

対象オブジェクト​

CSSクラス​

JSON 文法​

対象オブジェクト​

コレクションまたはエンティティセレクション​

JSON 文法​

対象オブジェクト​

データソース​

JSON 文法​

対象オブジェクト​

プラグインの種類​

JSON 文法​

対象オブジェクト​

ラジオグループ​

JSON 文法​

対象オブジェクト​

タイトル​

JSON 文法​

対象オブジェクト​

変数の計算​

JSON 文法​

対象オブジェクト​

タイプ

JSON 文法

対象オブジェクト

オブジェクト名

JSON 文法

対象オブジェクト

値を記憶

JSON 文法

対象オブジェクト

変数あるいは式

JSON 文法

式

ダイナミック変数

配列リストボックス

対象オブジェクト

式の型/式タイプ

JSON 文法

対象オブジェクト

CSSクラス

JSON 文法

対象オブジェクト

コレクションまたはエンティティセレクション

JSON 文法

対象オブジェクト

データソース

JSON 文法

対象オブジェクト

プラグインの種類

JSON 文法

対象オブジェクト

ラジオグループ

JSON 文法

対象オブジェクト

タイトル

JSON 文法

対象オブジェクト

変数の計算

JSON 文法

対象オブジェクト