4D Doc Center : FORM SET INPUT

4D v14.3

FORM SET INPUT


FORM SET INPUT ( {aTable ;} form {; userForm}{; *} )

aTable	テーブル	入力フォームを設定するテーブル, または省略した場合、デフォルトテーブル
form	文字	入力フォームとして設定するフォーム名
userForm	文字	使用するユーザフォーム名
*		自動ウィンドウサイズ

説明

FORM SET INPUTコマンドは、aTableのカレント入力フォームをformまたはuserFormに設定します。フォームはaTableに属していなければなりません。

このコマンドのスコープは、カレントプロセスです。各テーブルは、プロセスごとに個々の入力フォームを持っています。

Note: 構造的な理由から、このコマンドはプロジェクトフォームと互換がありません。プロジェクトフォームをformに渡しても、コマンドは何も行いません。

FORM SET INPUT はフォームを表示しません。データ入力や読み込み、他のコマンドで使用するフォームを指定するだけです。フォームの作成に関する詳細は4D Design Referenceマニュアルを参照してください。

デフォルト入力フォームはテーブルごとにエクスプローラウィンドウで指定します。このデフォルト入力フォームは、FORM SET INPUTコマンドで入力フォームを指定しない場合や、指定したフォームが存在しない場合に使用されます。

任意の引数userForm を使用して、(formを基に作成された) ユーザフォームをデフォルトの入力フォームとして設定することができます。有効なユーザフォーム名を渡すと、カレントプロセスの入力フォームに代わり、このフォームがデフォルトとして使用されます。これにより、(CREATE USER FORMコマンドで生成された) 複数の異なるカスタムユーザフォームを同時に使用できるようになり、現在の状況で適切なフォームを使用することができます。
ユーザフォームに関する詳細はの節を参照してください。

入力フォームは多くのコマンドで表示されますが、一般にデータの入力や修正に使用されます。以下のコマンドは、データ入力や検索用に入力フォームを表示します:

DISPLAY SELECTION や MODIFY SELECTIONコマンドは、出力フォームを使用してレコードのリストを表示します。ユーザがリスト上のレコードをダブルクリックすると、入力フォームを表示します。

データ読み込みコマンドIMPORT TEXT, IMPORT SYLK そして IMPORT DIFは、レコードの読み込みにカレント入力フォームを使用します。

オプション引数 * は、デザインモードのフォームプロパティウィンドウおよびOpen windowで使用されます。* を指定することにより、(ダイアログボックスや入力フォームとして) 次回フォームを使用する際、フォームプロパティの設定をもとに自動的にウィンドウサイズを変更するよう4Dに指示します。詳しくはOpen windowの節を参照してください。

Note: オプション引数 * を使用するしないに関係なく、FORM SET INPUTコマンドはテーブルの入力フォームを変更します。

例題 1

以下の例は、FORM SET INPUTコマンドの一般的な使用方法です:

 FORM SET INPUT([Companies];"New Comp") ` 新しい会社を追加するフォーム

 ADD RECORD([Companies]) ` 新しい会社の追加

例題 2

複数の会社を処理する請求書データベースでは、対応するユーザフォームを用いて請求書を作成しなくてはなりません:

 Case of

    :(company="4D SAS")

       FORM SET INPUT([Invoices];"Input";"4D_SAS")

    :(company="4D Inc")

       FORM SET INPUT([Invoices];"Input";"4D_Inc")

    :(company="Acme")

       FORM SET INPUT([Invoices];"Input";"ACME")

 End case

 ADD RECORD([Factures])