サブフォーム
サブフォームとは、他のフォームに組み込まれるフォームのことです。
用語
サブフォームに実装されたコンセプトを明確に説明するために、いくつかの用語についてここで定義します:
- サブフォーム: 他のフォームに組み込まれることを意図したフォーム。
- 親フォーム: 1つ以上のサブフォームを含むフォーム。
- サブフォームコンテナー: 親フォームに組み込まれた、サブフォームのインスタンスを表示するオブジェクト。
- サブフォームインスタンス: 親フォームに表示されたサブフォームの実体。 このコンセプトはとても重要です。親フォームには、同じサブフォームのインスタンスを複数表示することができるからです。
- リストフォーム: データをリストとして表示するサブフォームインスタンス。
- 詳細フォーム: リストサブフォームをダブルクリックすることでアクセスすることができる、ページタイプの入力フォーム。
リストサブフォーム
リストサブフォームを使うことで、他のテーブルのデータを入力、表示、および更新することができます。 通常は 1対Nリレーションが設定されたデータベースでリストサブフォームを使用します。 リレートされた 1テーブルのフォーム上のリストサブフォームでは、リレートされた Nテーブルのデータを入力・表示・更新します。 一つのフォーム上に、それぞれ異なるテーブルに属する複数のサブフォームを配置できます。 しかし、フォームの同じページ上には、同じテーブルに属するサブフォームを複数配置することはできません。
たとえば、連絡先管理データベースでは、ある連絡先のすべての電話番号を表示するためにリストサブフォームが使用されるでしょう。 連絡先テーブルの画面に電話番号が表示されますが、情報はリレートテーブルに格納されています。 1対Nリレーションを使用することで、このデータベース設計は連絡先ごとに複数の電話番号を簡単に格納できるようになっています。 自動リレーションにより、リレートされている Nテーブルへのデータ入力がプログラムなしで直接おこなうことができます。
リストサブフォームは通常 Nテーブルに結び付けられますが、それだけでなく他の任意のデータベーステーブルのレコードをサブフォームのインスタンスに表示することもできます。
また、ユーザーがリストサブフォームに直接データを入力するようにもできます。 サブフォームの設定に基づき、ユーザーがサブレコード上でダブルクリックするか、サブレコードを追加/編集するコマンドを使用すると、詳細フォームが表示されます。
4Dはサブレコードを管理する基本的なニーズに応える 3つの標準アクション
editSubrecord(サブレコード編集)、deleteSubrecord(サブレコード削除) およびaddSubrecord(サブレコード追加) を提供しています。 フォームに複数のサブフォームインスタンスが含まれる場合、フォーカスを持っているサブフォームにアクションが適用されます。
ページサブフォーム
ページサブフォームは、カレントサブレコードのデータや、コンテキストに基づく関連する値 (変数やピクチャーなど) を表示できます。 ページサブフォームを使用する利点の一つは、それらが高度な機能を提供したり、親フォームと相互作用したりできることです (ウィジェット)。 ページサブフォームには専用のプロパティやイベントがあり、プログラムから完全に制御することができます。
ページサブフォームは 詳細フォーム プロパティで指定された入力フォームを使用します。 リストサブフォームと異なり、使用されるフォームは親フォームと同じテーブルに所属していてもかまいません。 また、プロジェクトフォームを使用することもできます。 実行時、ページサブフォームは入力フォームと同じ標準の表示特性を持ちます。
4Dウィジェットは、ページサブフォームに基づいた定義済みの複合オブジェクトです。 詳細は専用のドキュメント 4D Widgets (ウィジェット) を参照してください。
バインドされた変数あるいは式の管理
サブフォームコンテナーオブジェクトには、変数あるいは式 をバインドすることができます。 これは、親フォームとサブフォーム間で値を同期するのに便利です。
By default, 4D creates a variable or expression of object type for a subform container, which allows you to share values in the context of the subform using the Form command (see below). However, you can use a variable or expression of any scalar type (time, integer, etc.) especially if you only need to share a single value:
- Define a bound variable or expression of a scalar type and call the
OBJECT Get subform container valueandOBJECT SET SUBFORM CONTAINER VALUEcommands to exchange values when On Bound Variable Change or On Data Change form events occur. この方法は、単一の値を同期させるのに推奨されます。 - または、バインドされた オブジェクト 型の変数あるいは式を定義し、
Formコマンドを使用してサブフォームからそのプロパティにアクセスします。 この方法は、複数の値を同期させるのに推奨されます。
親フォームとサブフォームの同期 (単一値)
親フォームにおいて、他のオブジェクトとサブフォームコンテナーとに同じ "変数あるいは式" を設定することで、親フォームとサブフォームのコンテキストをリンクし、洗練されたインターフェースを作成することができます。 たとえば、入力エリア が設置されている親フォームに、時刻を静的に表示するサブフォームを置くとします:
親フォームにおいて、両オブジェクト (入力エリアとサブフォームコンテナー) の 変数あるいは式 プロパティは同じ設定にされています。 変数 (例: parisTime)、あるいは式 (例: Form.parisTime) を設定することができます。
サブフォームにおいては、時計オブジェクトの同プロパティとして Form.clockValue が設定されています。
サブフォームの内容を更新する
ケース1: 親フォームの変数あるいは式の値が更新され、この更新をサブフォームに反映させる必要があります。
この例では、親フォームにおいて Form.parisTime の値がユーザー入力、あるいは動的に (たとえば String(Current time) コマンドで) "12:15:00" に変更されました。 これは、サブフォームのフォームメソッドで On Bound Variable Change イベントをトリガーします。
以下のコードが実行されます:
// Subform form method
If (Form event code=On Bound Variable Change) //bound variable or expression was modified in the parent form
Form.clockValue:=OBJECT Get subform container value //synchonize the local value
End if
上のコードは、サブフォームの Form.clockValue の値を更新します:
On Bound Variable Change フォームイベントは以下のときに生成されます:
- 親フォームの変数/式に値が割り当てられたとき (同じ値が再代入された場合でも) で、
- サブフォームが 0ページまたはカレントフォームページに置かれているとき。
Note that, as in the above example, it is preferable to use the OBJECT Get subform container value command which returns the value of the expression in the subform container rather than the expression itself because it is possible to insert several subforms in the same parent form (for example, a window displaying different time zones contains several clocks).
バインドされた変数あるいは式を変更すると、フォームイベントが発生し、親フォームとサブフォームの値を同期させることができます:
- 親フォームのサブフォームコンテナーの変数あるいは式が変更されたことをサブフォーム (のフォームメソッド) に通知するには、サブフォームの On Bound Variable Change フォームイベントを使用します。
- 同様に、サブフォーム内で変数あるいは式の値が変更されたことを親フォームのサブフォームコンテナーに通知するには、サブフォームの On Data Change フォームイベントを使用します。
親フォームの内容を更新する
ケース2: サブフォームの内容が更新され、その更新を親フォームに反映させる必要があります。
サブフォーム内で、時計オブジェクトに紐づいた Form.clockValue 式 (テキスト型) の値がボタンによって変更されます。 これにより、時計オブジェクトの内部で On Data Change フォームイベント (当該イベントがオブジェクトに対して選択されている必要があります) がトリガーされ、親フォームの Form.parisTime 値を更新します。
以下のコードが実行されます:
// subform clock object method
If (Form event code=On Data Change) //whatever the way the value is changed
OBJECT SET SUBFORM CONTAINER VALUE(Form.clockValue) //Push the value to the container
End if
サブフォームの Form.clockValue の値が変化するたびに、サブフォームコンテナーの Form.parisTime も更新されます。
変数あるいは式の値が複数の場所で設定されている場合、4D は最後にロードされた値を使用します。 以下のロード順が適用されます:
1 - サブフォームのオブジェクトメソッド
2 - サブフォームのフォームメソッド
3 - 親フォームのオブジェクトメソッド
4 - 親フォームのフォームメソッド
親フォームとサブフォームの同期 (複数値)
デフォルトで、4D は各サブフォームコンテナーに オブジェクト型 の変数あるいは式を作成します。 このオブジェクトの中身は親フォームおよびサブフォームから読み書き可能なため、ローカルなコンテキストにおいて複数の値を共有することができます。
親フォームのサブフォームコンテナーにバインドされたオブジェクトは、サブフォーム内では直接 Form コマンドによって返されます。 オブジェクトは常に参照によって渡されるため、ユーザーがサブフォーム内でプロパティ値を変更した場合には、その値は自動的にオブジェクト自身に保存され、親フォームでも利用できるようになります。 一方、ユーザーによって、あるいはプログラミングによってオブジェクトのプロパティが親フォーム内で変更された場合も、その値はサブフォーム内で自動更新されます。 つまり、イベント管理は必要ありません。
たとえば、サブフォームでは、入力は (サブフォームの) Form オブジェクトプロパティにバインドされています。
親フォームで、このサブフォームを 2回表示するとします。 各サブフォームコンテナーは、(親フォームの) Form オブジェクトのプロパティである式にバインドされています。
下のボタンは、親フォームの Form オブジェクトに mother と father プロパティを作成します。
// Add values ボタンのオブジェクトメソッド
Form.mother:=New object("lastname"; "Hotel"; "firstname"; "Anne")
Form.father:=New object("lastname"; "Golf"; "firstname"; "Félix")
フォームを実行してボタンをクリックすると、サブフォームを含め、すべての値が正しく表示されていることがわかります:
同じオブジェクトが使用されているため、親フォームまたはサブフォームで値を変更すると、もう一方のフォームでも値が自動更新されます:
ポインターの使用 (互換性)
4D v19 R5 以前のバージョンでは、親フォームとサブフォーム間の同期は ポインター を使っておこなわれていました。 たとえば、サブフォームオブジェクトを更新するには、以下のコードを呼び出しておこえます:
// Subform form method
If (Form event code=On Bound Variable Change)
ptr:=OBJECT Get pointer(Object subform container)
clockValue:=ptr->
End if
**この方法は互換性のために引き続きサポートされますが、サブフォームに式をバインドすることができないため、廃止予定となります。**今後の開発では、この原則は使うべきではありません。 In any cases, we recommend to use the Form command or the OBJECT Get subform container value and OBJECT SET SUBFORM CONTAINER VALUE commands to synchronize form and subform values.
高度なフォーム間通信プログラム
親フォームとサブフォームインスタンス間の通信では、バインドした変数を通して値を交換する以上のことをおこなう必要がある場合があります。 実際、親フォームでおこなわれたアクションに基づきサブフォーム中の変数を更新したり、その逆の処理をしたい場合があるでしょう。 先の "動的な時計" タイプのサブフォームの例で言えば、各時計ごとにアラーム時刻を複数設定したい場合が考えられます。
このようなニーズにこたえるため、4Dは以下のメカニズムを実装しています:
CALL SUBFORM CONTAINERコマンドを使用してサブフォームからコンテナーオブジェクトを呼び出す、EXECUTE METHOD IN SUBFORMコマンドを使用してサブフォームのコンテキストでメソッドを実行する。
GOTO OBJECTはサブフォームから実行されても、親フォーム内にて目的のオブジェクトを検索します。
CALL SUBFORM CONTAINER コマンド
CALL SUBFORM CONTAINER コマンドを使用すると、サブフォームインスタンスからサブフォームコンテナーオブジェクトに イベント を送信できます。 イベントはコンテナーオブジェクトメソッドで受信されます。 (クリックやドラッグ＆ドロップなど) サブフォームにより検知されたすべてのイベントの発生元となりえます。
送信するイベントコードに制限はありません (たとえば 20000 や -100 など)。 既存のイベントに対応するコード (たとえば On Validate に対応する 3) を使用することも、カスタムコードを使用することもできます。 前者のケースでは、サブフォームコンテナーのプロパティリストでチェックを入れたイベントのみを使用できます。 後者の場合、使用するコードは既存のフォームイベントに対応してはいけません。 将来の 4Dバージョンで番号が衝突しないようにするために、負数の使用が推奨されます。
詳細は CALL SUBFORM CONTAINER コマンドの説明を参照してください。
EXECUTE METHOD IN SUBFORM コマンド
EXECUTE METHOD IN SUBFORM コマンドを使用すると、親フォームやそのオブジェクトから、サブフォームインスタンスのコンテキストにおけるメソッド実行をリクエストできます。これにより、サブフォームの変数やオブジェクト等にアクセスすることができます。 このメソッドは引数も受け取れます。
このメカニズムを図示すると以下のようになります:
詳細は EXECUTE METHOD IN SUBFORM コマンドの説明を参照してください。
プロパティ一覧
Border Line Style - Bottom - Class - Detail Form - Double click on empty row - Double click on row - Enterable in list - Expression Type - Focusable - Height - Hide focus rectangle - Horizontal Scroll Bar - Horizontal Sizing - Left - List Form - Method - Object Name - Print Frame - Right - Selection mode - Source - Top - Type - Variable or Expression - Vertical Scroll Bar - Vertical Sizing - Visibility - Width