対話編集ステートメント

DPLの実行を一時中断して，カーソルで指定されたファイルの対話編集モードに入ります。対話編集モードでは利用者がメニューコマンドやカードのボタンを使ってデータ編集などを行ないます。その後，対話編集モードを終了すると再びDPLの実行が始まります。

形式

パラメータ

<カーソル名>

対話編集の対象となるファイル (表，カードまたはビュー) を指定します。対話編集を開始するときに，<カーソル名> が指している位置へウィンドウのセルカーソルが移動します。省略するとカレントカーソルが指しているファイルを編集します。

項目

対話編集を開始するときにセルカーソルが指す項目を指定します。省略すると，初期状態が 表示／項目訂正／連続訂正／レコード訂正 の場合は直前にカーソル移動ステートメントなどで移動された位置になり，初期状態が レコード挿入／連続挿入／レコード追加／連続追加／カード挿入 の場合は，挿入されるレコードの最初の項目になります。

参考：	レコード挿入時の最初のセルカーソルの位置は，DBPro初期化ファイルの InsertCursorLeft パラメータによって変更できます。

初期状態

対話編集を開始するとき，どのような状態で開始するかを指定します。

表示	表示モードで開始します。（既定値）
項目訂正	カーソル位置の１項目訂正で開始します。
連続訂正	カーソル位置から連続訂正で開始します。
レコード訂正	カーソル位置から連続訂正で開始しますが，その１レコード内のみで連続訂正ができます。他のレコードに移ると表示モードになります。
レコード挿入	カーソル位置に１レコード挿入で開始します。１レコード分の入力が終わると表示モードになります。
連続挿入	カーソル位置からレコード挿入で開始します。
レコード追加	カーソル位置に関わりなく，グループ末尾（グループ項目が指定してあり，表オブジェクトをもつカードの場合）または表の末尾（それ以外の場合）に１レコード挿入して開始します。１レコード分の入力が終わると表示モードになります。
連続追加	カーソル位置に関わりなく，グループ末尾（グループ項目が指定してあり，表オブジェクトをもつカードの場合）または表の末尾（それ以外の場合）でレコードの連続挿入を開始します。
カード挿入	カードが対象のとき，新規のカードを挿入してレコード挿入を開始します。対象がカードでないときは連続挿入と同じです。ただし，グループが指定されていないカードでは，カード挿入 は無効です。

初期化

初期状態が レコード挿入／連続挿入／レコード追加／連続追加／カード挿入 の場合にだけ意味をもち，最初のレコードを挿入すると同時に指定した項目の初期値式を評価することを指定します。これにより，利用者がデータを入力する時点で，指定した項目に何らかのデータが入力済みの状態で入力させることができます。
初期値式が #対話表引き を含む場合，それは対話を伴なわない表引きとして動作します。

初期動作

訂正またはレコード挿入を開始する最初の項目に対しての動作を指定します。初期状態が 表示 のときは何もしません。

なし	何もしません。（既定値）
初期値	初期値式を評価して，その値を設定します。
直前値	直前のレコードの同じ項目の値を設定します。
直前行	初期状態が レコード挿入／連続挿入／レコード追加／連続追加／カード挿入 のときだけ有効であり，すべての項目について直前のレコードの値を設定します。
ファイル名	ファイル選択ダイアログを表示してファイル名を入力させます。

表示状態

訂正やレコード挿入が終わったとき，ただちに対話編集を終了するかどうかを指定します。初期状態が 表示 のときは無視されます。

許可	訂正やレコード挿入が終わっても，表示モードのままで対話編集に留まります。（既定値）
禁止	訂正やレコード挿入が終わると，自動的に対話編集も終了します。

結果

例

構造	コマンド	パラメータ
	オープン	@MASTER, 'MASTER.DPT'
	対話編集	@MASTER, 初期状態=連続訂正

解説

対話編集モード

• 対話編集コマンドを実行すると，実行中のDPLが一時中断され，<カーソル名> で指定されたファイルの対話編集モードになります。対話編集中は，通常の対話操作で行なえるすべての対話操作が可能です。他のウィンドウへ移動することもできますし，ウィンドウをクローズしてしまうことも可能です。
• 対話編集中は，そのウィンドウのステータスバーの実行中表示が「対話中」に変わります。
• 対話編集の終了は，対話編集終了ステートメントまたは[ファイル]-[実行]-[対話終了]で行ないます。
  対話編集を終了すると，そのときのウィンドウのセルカーソルの位置が，対話編集ステートメントで指定したカーソルおよびカレントカーソルに設定されます。

表示状態禁止の対話編集

• 特定の項目やレコードの訂正だけを対話編集で行なわせたい場合，あるいは新たなレコードの入力だけを対話編集で行なわせたい場合は，初期状態パラメータで訂正や挿入を指定したうえ，表示状態パラメータで 禁止 を指定します。表示状態禁止を指定した対話編集では，対話編集終了ステートメントや [ファイル]-[実行]-[対話終了] を実行しなくても，訂正モードやレコード挿入モードが終了すると自動的に対話編集が終了します。
• 対話編集中に訂正モードやレコード挿入モードを終了させる代表的な例としてカード上のボタンを押した場合があります。この場合，そのボタンの属性によって次のように動きが変わります。

  メニューコマンドが割り当てられているボタン

  • [挿入・訂正モードを終了しない]が無効な場合，レコード挿入，訂正モードから表示モードに戻り，ボタンに割り当てられた機能が実行された後，対話編集が終了します。このとき，システム変数 $$OBJECT の値は空文字列になります。
  • [挿入・訂正モードを終了しない]が有効な場合，その機能が実行されて，対話編集も継続します。ただし，[挿入／訂正モードを終了しない]を指定してもボタンに割り当てられているコマンドによっては表示モードに戻ることがあります。[挿入・訂正モードを終了しない]

  ファイルが割り当てられているボタン

  メニューコマンドが割り当てられている場合と同じです。

  なし：カード手続きによる実行が割り当てられているボタン

  • [挿入・訂正モードを終了しない]が無効な場合，レコード挿入，訂正モードから表示モードに戻り，同時に対話編集が終了します。このとき，そのボタンに割り当てられたカード手続きは実行されず，システム変数 $$OBJECT にそのボタンのオブジェクト名が設定されます。
  • [挿入・訂正モードを終了しない]が有効な場合，挿入／訂正モードのままカード手続きが実行されます。いつ表示モードに戻るか，あるいは挿入／訂正中のレコードの内容が確定されるか破棄されるかなどは，カード手続きとして記述されたDPLによります。挿入／訂正モードでは実行できないコマンドをDPL中で実行しようとした場合，挿入／訂正中のレコードの内容は破棄されるので注意してください 。

対話編集中に閉じられたファイル

• 対話編集中のウィンドウを，対話編集終了ステートメントや [ファイル]-[実行]-[対話終了] を実行せずに閉じてしまってもかまいません。その対話編集は終了し，DPLの実行が再開されます。
• 対話編集中のウィンドウが閉じられた場合，対話編集ステートメントで指定したカーソルは未使用状態になります。DPLの再開後，そのカーソルが参照されなければ DPL は正常に実行されますが，一般的にはそのカーソルを参照した時点でエラーになります。
• 対話編集中に閉じてしまったその他の表やカードを指しているDPL中のカーソルも，すべて未使用状態になります。

カード手続きと対話編集の入れ子

• <カーソル名> が示しているファイルにカード手続きが指定されているときは，対話編集中にカード上のボタンを押すことによってそれぞれの手続きを実行させることができます。
• カード手続き中で更に対話編集ステートメントを実行し，対話編集モードを入れ子にすることができます。
  このとき，対話編集ステートメントで指定するファイルは，すでに対話編集状態になっている同じファイルであってもかまいません。ただし，ある対話編集ステートメントで開始された対話編集が終了しないうちに，その同じ対話編集ステートメントで再び対話編集を開始することはできません。対話編集の入れ子は，異なるステートメントで開始する場合にだけ許されます。

  例：

  構造	コマンド	パラメータ
  	…
  	対話編集	@X	(1)
  	…
  ON [ボタン１] DO	…
  	対話編集	@X	(2)
  	…

  (1) の対話編集の後，[ボタン１] によって再び同じファイルに対する対話編集に入っています。この場合，最初の対話編集終了によって (2) の対話編集が終了し，次の対話編集終了によって (1) の対話編集が終了します。

  (2) で対話編集に入った後，(2) の対話編集を終了せずに，[ボタン１] を押して再び (2) を実行しようとするとエラーになります。

注意

• 次のような場合，初期状態の指定によっては $$CMDSTATE に 201（カーソルが正しくない）が返り，対話編集には入れません。
  • 編集可能なオブジェクトのないカードに対して，初期状態として訂正やレコード挿入を指示するパラメータを指定した。
  • 末尾にカーソルがあるときに，訂正を指示するパラメータを指定した。
  • 集計表に対して，訂正やレコード挿入を指示するパラメータを指定した。

関連項目

対話編集終了ステートメント

CARDPROCEDUREステートメント

[ファイル]-[実行]

DPLの構文

$$CMDSTATE一覧