目次

# Database Form Events

The Events tab page, allows you to assign a macro to certain events which occur in a database form.

このコマンドの見つけ方

Open context menu of a selected form element - choose Form Properties - Events tab.

Open Form Design toolbar, click Form Properties icon - Events tab.

イベントとマクロを関連付けるには、まずイベントの発生時に実行する必要のあるコマンドをすべて含めたマクロを記述します。次に、対応するイベントにこのマクロを割り当てます。そのためには、対応するイベントの横にある「...」ボタンをクリックします。これによって、マクロの割り当て ダイアログが開くので、マクロを選択することができます。

以下のアクションは、ユーザーが自由に構成できます。すなわち、ユーザー独自のダイアログを使用して、アクションを表示できます。

1. エラーメッセージの表示、

2. (レコードの)削除処理の確認、

3. パラメーターのクエリー、

4. およびレコードを保存する際の入力のチェック

例えば、データレコードの削除時に、「本当に顧客 xyz を削除しますか?」などのメッセージを表示する「削除確認」要求を出すことができます。

The events that are shown in the Events dialog cannot be edited directly. You can remove an event from the list by pressing the Del key.

次に、マクロに関連付けることができるフォーム内の全イベントとその説明を示します:

## アンロードする前

The Before unloading event occurs before the form is unloaded; that is, separated from its data source.

## アンロードする時

The When unloading event occurs directly after the form has been unloaded; that is, separated from its data source.

## エラーが生じた場合

The Error occurred event is activated if an error occurs when accessing the data source. This applies to forms, list boxes and combo boxes.

## サブミットする前

The Before submitting event occurs before the form data is sent. Returning True approves the submission, False stops it.

## パラメーターで入れる

The Fill parameters event occurs when the form to be loaded has parameters that must be filled out. For example, the data source of the form can be the following SQL command:

SELECT * FROM address WHERE name=:name

Here :name is a parameter that must be filled out when loading. The parameter is automatically filled out from the parent form if possible. If the parameter cannot be filled out, this event is called and a linked macro can fill out the parameter. Return True when the execution of the parametrized statement should continue, False otherwise.

## レコードのアクション実行前

The Before record action event occurs before the current record or record set are changed. Return True when changing is allowed, otherwise False. For example, the linked macro can request confirmation in a dialog.

## レコードのアクション実行後

The After record action event occurs directly after the current record has been changed.

## レコード置換前

The Before record change event occurs before the current record pointer - SQL cursor - is changed. Return True when moving is allowed, otherwise False.

## レコード置換後

The After record change event occurs directly after the current record pointer has been changed.

## 再ロードする前

The Before reloading event occurs before the form is reloaded. The data content has not yet been refreshed.

## 再読み込み時

The When reloading event occurs directly after the form has been reloaded. The data content has already been refreshed.

## 削除の確認時

The Confirm deletion event occurs as soon as data has been deleted from the form. Return True to allow row deletion, False otherwise. For example, the linked macro can request confirmation in a dialog.

## 更新する前

The Before update event occurs before the control content changed by the user is written into the data source. The linked macro can, for example, prevent this action by returning FALSE.

## 更新した後

The After update event occurs after the control content changed by the user has been written into the data source.

## 元に戻す前

The Prior to reset event occurs before a form is reset. Returning True approves the reset, returning False cancels the operation.

以下の条件の１つを満たしていれば、フォームをリセットします。

1. ユーザーが、リセットボタンとして定義されている (HTML)ボタンを押す

2. データソースに関連付けられているフォーム内で、新しい空白のレコードを作成します。例えば、最後のレコードでボタン 次のレコード を押した場合などが考えられます。

## 元に戻した後

The After resetting event occurs after a form has been reset.

## 読み込む時

The When loading event occurs directly after the form has been loaded.

## Vetoable events

Macros can interrupt event execution when they return a boolean value: True allows the execution of the event to continue and False stops the event execution.

The following events are interruptable by returning False:

- Before record action

- Before record change

- Before submitting

- Before update

- Fill parameters