4D v16.3ADD RECORD |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v16.3
ADD RECORD
ADD RECORD
ADD RECORD コマンドは、データベースのテーブルaTableまたはaTableが省略された場合デフォルトテーブルに、ユーザが新規レコードを追加できるようにします。 ADD RECORD は新しいレコードを作成、それをカレントプロセスのカレントレコードとし、カレントの入力フォームを表示します。アプリケーションモードにおいて、ユーザが新しいレコードを受け入れると、新しいレコードがカレントセレクションにある唯一のレコードになります。 次の図は、典型的なデータ入力フォームです。 このフォームはこのプロセスの最前面のウインドウに表示されます。ウインドウには、スクロールバーとサイズボックスがあります。オプションの * 引数を指定すると、スクロールバーがないウインドウを描画され、フォームウィンドウは縮小することができなくなります ADD RECORD は、ユーザがレコードを受け入れるか取り消すまでフォームを表示します。ユ-ザが複数のレコ-ドを追加する場合は、新しいレコードごとに1回ずつコマンドを実行しなければなりません。 ユーザが保存ボタンをクリック、またはenterキーを押す、またはACCEPTコマンドが実行されると、レコードが保存されます。 ユーザがキャンセルボタンをクリック、またはキャンセルキーコンビネーション (WindowsではCtrl-ピリオド、Mac OSではCommand-ピリオド) を押す、またはCANCEL コマンドが実行されると、レコードは保存されません。 注: このコマンドでは、aTable に渡したテーブルが読み書き可能モードである必要はありません。テーブルが読み込みのみモードの場合でも使用する事ができます(レコードのロックを参照して下さい)。 ADD RECORD の呼び出し後、システム変数OKにはレコードが受け入れられると1が、キャンセルされると0が設定されます。 Note: キャンセルされた場合でも、レコードはメモリ上に残されたままとなります。カレントレコードポインタが変更される前にSAVE RECORDコマンドを実行すれば、レコードは保存されます。 次の例は、データベースに新しいレコードを追加する際によく使われるループです: FORM SET INPUT([Customers];"Std Input") ` [Customers] テーブルの入力フォームを設定 次の例は、顧客データを検索し、その検索結果により、2つのステートメントうちの1つを実行します。顧客が全く見つからない場合、ユーザはADD RECORDコマンドで新しい顧客を追加できます。少なくとも1つの顧客レコードが見つかった場合は、MODIFY RECORDにより最初のレコードが表示され、このレコードを修正できます: READ WRITE([Customers]) レコードを受け入れるとOKシステム変数が1に、キャンセルすると0に設定されます。OKシステム変数はレコードが受け入れられたかキャンセルされた後に設定されます。
参照
|
プロパティ
プロダクト: 4D 履歴
初出: < 4D v6 ARTICLE USAGE
ランゲージリファレンス ( 4D v16) |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||