Contenido

# Database Form Events

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

Para acceder a esta orden…

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

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

Para enlazar un evento con una macro, primero grabe una macro que contenga todas las órdenes que deban ejecutarse cuando se produzca el evento. Luego, asigne esta macro al evento respectivo: para ello, pulse en el botón … ubicado junto al evento. Se abrirá la ventana Asignar macro, que le permitirá seleccionar la macro.

Se pueden configurar las acciones siguientes de manera individual, es decir, puede usar sus propios cuadros de diálogo para representar una acción:

1. Mostrar un mensaje de error,

2. Confirmar un proceso de eliminación (de registros de datos),

3. Consultar parámetros,

4. así como comprobar las entradas al guardar un registro.

Por ejemplo, es posible crear una solicitud de «confirmación de eliminación» como «¿Realmente quiere eliminar el cliente xyz?» al suprimir un registro de datos.

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.

A continuación se enumeran y describen todos los eventos de formulario que pueden enlazarse con una macro:

## Al cargar

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

## Al descargar

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

## Al recargar

El evento Al recargar acaece inmediatamente después de que se ha vuelto a cargar el formulario. El contenido de los datos ya se ha actualizado.

## Antes de actualizar

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.

## Después de actualizar

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

## Antes de restablecer

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

Se restablecerá un formulario cuando se cumpla una de las siguientes condiciones:

1. El usuario pulsa un botón (HTML) que se ha definido como botón Restablecer.

2. Se crea un registro nuevo vacío en un formulario vinculado al origen de datos. Por ejemplo, se puede pulsar el botón Registro siguiente en el último registro.

## Después de restablecer

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

## Antes de descargar

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

## Antes de la acción del registro de datos

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.

## Antes de recargar

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

## Antes del cambio del registro de datos

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

## Antes del envío

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

## Confirmar eliminación

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.

## Ha ocurrido un error

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

## Rellenar parámetros

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.

## Tras el cambio del registro de datos

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

## Tras la acción del registro de datos

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

## 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