LibreOffice 24.8 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