Eventoj
The Events tab page, allows you to assign a macro to certain events which occur in a form.
To link an event with a macro, first write a macro that contains all the commands to be executed when the event happens. Then assign this macro to the respective event by clicking the ... button beside the corresponding event. The Assign Macro dialog opens, where you can select the macro.
The following actions can be configured individually, meaning that you can use your own dialogs to depict an action:
-
Displaying an error message,
-
Confirming a delete process (for data records),
-
Querying parameters,
-
Checking input when saving a data record.
For example, you can issue a "confirm deletion" request such as "Really delete customer xyz?" when deleting a data record.
The events that are shown in the Events dialog cannot be edited directly. You can delete an event from the list by pressing the Del key.
The following lists and describes all events in a form that can be linked to a macro:
Antaŭ malŝargo
The Before unloading event occurs before the form is unloaded; that is, separated from its data source.
Antaŭ reŝargado
The Before reloading event occurs before the form is reloaded. The data content has not yet been refreshed.
Antaŭ rikorda ago
The Before record action event occurs before the current record is changed. For example, the linked macro can request confirmation in a dialog.
Antaŭ rikordoŝanĝo
The Before record change event occurs before the current record pointer is changed. For example, the linked macro can prevent this action by returning "FALSE".
Antaŭ sendo
The Before submitting event occurs before the form data is sent.
Antaŭ ĝisdatigo
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".
Post ĝisdatigo
The After update event occurs after the control content changed by the user has been written into the data source.
Antaŭ restartigo
The Prior to reset event occurs before a form is reset. The linked macro can, for example, prevent this action by returning "FALSE".
A form is reset if one of the following conditions is met:
-
The user presses an (HTML) button that is defined as a reset button.
-
A new and empty record is created in a form that is linked to a data source. For example, in the last record, the Next Record button may be pressed.
Post reagordo
The After resetting event occurs after a form has been reset.
Dum reŝargado
The When reloading event occurs directly after the form has been reloaded. The data content has already been refreshed.
Dum ŝargado
The When loading event occurs directly after the form has been loaded.
Eraro okazis
The Error occurred event is activated if an error occurs when accessing the data source. This applies to forms, list boxes and combo boxes.
Konfirmi forigon
The Confirm deletion event occurs as soon as data has been deleted from the form. For example, the linked macro can request confirmation in a dialog.
Plenigi parametrojn
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.
Post rikorda ago
The After record action event occurs directly after the current record has been changed.
Post rikordoŝanĝo
The After record change event occurs directly after the current record pointer has been changed.
Tuj post malŝargo
The When unloading event occurs directly after the form has been unloaded; that is, separated from its data source.