LibreOffice 7.6 Help
The Events tab page, allows you to assign a macro to certain events which occur in a database form.
āĻāĻāĻāĻŋ āĻāĻā§āύā§āĻāĻā§ āĻāĻāĻāĻŋ āĻŽā§āϝāĻžāĻā§āϰā§āϰ āϏāĻžāĻĨā§ āϞāĻŋāĻāĻ āĻāϰāϤā§, āĻĒā§āϰāĻĨāĻŽā§ āĻāĻāĻāĻŋ āĻŽā§āϝāĻžāĻā§āϰ⧠āϞāĻŋāĻā§āύ āϝāĻž āϝāĻāύ āĻāĻā§āύā§āĻāĻāĻŋ āϏāĻāĻāĻ āĻŋāϤ āĻšāĻŦā§ āϤāĻāύ āϏāĻŽā§āĻĒāĻžāĻĻāĻŋāϤ āĻāϰāĻžāϰ āĻāύā§āϝ āϏāĻŦ āĻāĻŽāĻžāύā§āĻĄ āϧāĻžāϰāĻŖ āĻāϰā§āĨ¤ āϏāĻāĻļā§āϞāĻŋāώā§āĻ āĻāĻā§āύā§āĻā§āϰ āĻĒāĻžāĻļā§ ... āĻŦā§āϤāĻžāĻŽā§ āĻā§āϞāĻŋāĻ āĻāϰ⧠āĻāϰāĻĒāϰ āĻāĻ āĻŽā§āϝāĻžāĻā§āϰ⧠āύāĻŋāĻ āύāĻŋāĻ āĻāĻā§āύā§āĻā§ āĻŦāϰāĻžāĻĻā§āĻĻ āĻāϰā§āύāĨ¤ āĻŽā§āϝāĻžāĻā§āϰ⧠āĻŦāϰāĻžāĻĻā§āĻĻ āĻāϰā§āύ āĻĄāĻžā§āĻžāϞāĻ āĻā§āϞāĻŦā§, āϝā§āĻāĻžāύ⧠āĻāĻĒāύāĻŋ āĻŽā§āϝāĻžāĻā§āϰ⧠āύāĻŋāϰā§āĻŦāĻžāĻāύ āĻāϰāϤ⧠āĻĒāĻžāϰāĻŦā§āύāĨ¤
āύāĻŋāĻŽā§āύā§āĻā§āϤ āĻāĻžāĻ āϏā§āĻŦāϤāύā§āϤā§āϰāĻāĻžāĻŦā§ āĻāύāĻĢāĻŋāĻāĻžāϰ āĻāϰāĻž āϝā§āϤ⧠āĻĒāĻžāϰā§, āĻāϰ āĻŽāĻžāύ⧠āĻšāϞ āĻāĻāĻāĻŋ āĻāĻžāĻ āĻāĻžāϞāĻžāϤ⧠āĻāĻĒāύāĻžāϰ āύāĻŋāĻāϏā§āĻŦ āĻāĻāĻāĻŋ āĻĄāĻžāϝāĻŧāĻžāϞāĻ āĻŦā§āϝāĻŦāĻšāĻžāϰ āĻāϰāϤ⧠āĻĒāĻžāϰā§āύāĨ¤
āĻāĻāĻāĻŋ āϤā§āϰā§āĻāĻŋ āĻŦāĻžāϰā§āϤāĻž āĻĒā§āϰāĻĻāϰā§āĻļāύ āĻāϰāĻā§,
āĻŽā§āĻā§ āĻĢā§āϞāĻžāϰ āĻāĻāĻāĻŋ āĻĒā§āϰāĻā§āϰāĻŋāϝāĻŧāĻž āύāĻŋāĻļā§āĻāĻŋāϤ āĻāϰāĻā§ (āĻĄāĻžāĻāĻž āϰā§āĻāϰā§āĻĄā§āϰ āĻāύā§āϝ),
āĻāĻŋāĻā§āĻāĻžāϏāĻ āĻĒā§āϝāĻžāϰāĻžāĻŽāĻŋāĻāĻžāϰ,
āĻāĻāĻāĻŋ āĻĄāĻžāĻāĻž āϰā§āĻāϰā§āĻĄ āϏāĻāϰāĻā§āώāύā§āϰ āϏāĻŽāϝāĻŧ āĻāύāĻĒā§āĻ āĻĒāϰā§āĻā§āώāĻž āĻāϰāĻā§āĨ¤
āĻāĻĻāĻžāĻšāϰāĻŖāϏā§āĻŦāϰā§āĻĒ, āĻāĻāĻāĻŋ āϰā§āĻāϰā§āĻĄ āĻŽā§āĻā§ āĻĢā§āϞāĻžāϰ āϏāĻŽāϝāĻŧ āĻāĻĒāύāĻŋ "āĻŽā§āĻā§ āĻĢā§āϞāĻž āύāĻŋāĻļā§āĻāĻŋāϤāĻāϰāĻŖ" āĻ āύā§āϰā§āϧ āϝā§āĻŽāύ, "āϏāϤā§āϝāĻŋāĻ āĻāĻŋ āĻā§āϰāĻžāĻšāĻ 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 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 reloading event occurs before the form is reloaded. The data content has not yet been refreshed.
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 submitting event occurs before the form data is sent. Returning True approves the submission, False stops it.
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 When unloading event occurs directly after the form has been unloaded; that is, separated from its data source.
The When loading event occurs directly after the form has been loaded.
The When reloading event occurs directly after the form has been reloaded. The data content has already been refreshed.
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 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.
āĻāĻ āύāĻāĻŋ āĻĒā§āύāϰāĻžāϝāĻŧ āύāĻŋāϝā§āĻā§āϤ āĻšāϝāĻŧ āϝāĻĻāĻŋ āύāĻŋāĻŽā§āύā§āĻā§āϤ āϝā§āĻā§āύ⧠āĻāĻāĻāĻŋ āĻļāϰā§āϤ āĻĒā§āϰāĻŖ āĻāϰāĻž āĻšāϝāĻŧ:
āĻŦā§āϝāĻŦāĻšāĻžāϰāĻāĻžāϰ⧠āĻāĻāĻāĻŋ HTML āĻŦā§āϤāĻžāĻŽ āĻāĻžāĻĒā§ āϝāĻž āĻĒā§āύāϰāĻžāϝāĻŧ āύāĻŋāϝā§āĻā§āϤāĻāϰāĻŖ āĻŦā§āϤāĻžāĻŽ āĻšāĻŋāϏā§āĻŦā§ āĻŦā§āϝāĻžāĻā§āϝāĻžāĻā§āϤāĨ¤
āĻāĻāĻāĻŋ āύāϤā§āύ āĻāĻŦāĻ āĻĢāĻžāĻāĻāĻž āϰā§āĻāϰā§āĻĄ āĻāĻāĻāĻŋ āĻĢāϰā§āĻŽā§ āϤā§āϰāĻŋ āĻāϰāĻž āĻšāĻŦā§ āϝāĻž āĻāĻāĻāĻŋ āĻĄāĻžāĻāĻž āĻā§āϏā§āϰ āϏāĻžāĻĨā§ āϏāĻāϝā§āĻā§āϤāĨ¤ āĻāĻĻāĻžāĻšāϰāĻŖāϏā§āĻŦāϰā§āĻĒ, āĻļā§āώ āϰā§āĻāϰā§āĻĄā§, āĻĒāϰāĻŦāϰā§āϤ⧠āϰā§āĻāϰā§āĻĄ āĻŦā§āϤāĻžāĻŽ āϏāĻŽā§āĻāĻŦāϤ āĻāĻžāĻĒāĻž āĻšāĻŦā§āĨ¤
The After resetting event occurs after a form has been reset.
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