Ayuda de LibreOffice 26.8
La página ventos le permite asignar una macro a ciertos eventos que ocurren en forma de base de datos.
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 diálogos para representar una acción:
Mostrar un mensaje de error,
Confirmar un proceso de eliminación (de registros de datos),
Consultar parámetros,
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.
Los eventos que se muestran en el diálogo Eventos no se pueden editar de forma directa. Puede quitar un evento de la lista presionando la tecla Supr.
A continuación se enumeran y describen todos los eventos de formulario que pueden enlazarse con una macro:
El evento Al cargar ocurre directamente después de que se haya cargado el formulario.
El evento Al descargar ocurre inmediatamente después de que se haya descargado el formulario; es decir, separado de su fuente de datos.
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.
El evento Antes de la actualización ocurre antes de que el contenido del control modificado por el usuario se escriba en la fuente de datos. La macro vinculada puede, por ejemplo, evitar esta acción devolviendo FALSE.
El evento Después de la actualización ocurre después de que el contenido del control modificado por el usuario se haya escrito en la fuente de datos.
El evento Antes de restablecer ocurre antes de que se restablezca un formulario. Devolver True aprueba el restablecimiento, devolver False cancela la operación.
Se restablecerá un formulario cuando se cumpla una de las siguientes condiciones:
El usuario pulsa un botón (HTML) que se ha definido como botón Restablecer.
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.
El evento Después de restablecer ocurre después de que se haya restablecido un formulario.
El evento Antes de descargar ocurre antes de que se descargue el formulario; es decir, separado de su fuente de datos.
El evento Antes de la acción del registro ocurre antes de que se cambie el registro actual o el conjunto de registros. Devuelve True cuando se permite el cambio; de lo contrario, False. Por ejemplo, la macro vinculada puede solicitar confirmación en un diálogo.
El evento Antes de recargar ocurre antes de que se vuelva a cargar el formulario. El contenido de los datos aún no se ha actualizado.
El evento Antes del cambio de registro ocurre antes de que se cambie el puntero del registro actual (cursor SQL). Devuelve True cuando se permite el movimiento; de lo contrario, False.
El evento Antes de enviar ocurre antes de que se envíen los datos del formulario. Devuelve True aprueba el envío, False lo detiene.
El evento Confirmar eliminación ocurre tan pronto como se eliminan los datos del formulario. Devuelve Verdadero para permitir la eliminación de filas, Falso en caso contrario. Por ejemplo, la macro vinculada puede solicitar confirmación en un diálogo.
El evento Ocurrió un Error se activa si ocurre un error al acceder a la fuente de datos. Esto se aplica a formularios, cuadros de lista y cuadros combinados.
El evento Rellenar parámetros ocurre cuando el formulario a cargar tiene parámetros que deben completarse. Por ejemplo, la fuente de datos del formulario puede ser el siguiente comando SQL:
SELECT * FROM address WHERE name=:name
Aquí :name es un parámetro que debe completarse al cargar. Si es posible, el parámetro se completa automáticamente desde el formulario principal. Si el parámetro no se puede completar, se llama a este evento y una macro vinculada puede completar el parámetro. Devuelve True cuando la ejecución de la declaración parametrizada debe continuar, Falso en caso contrario.
El evento Después del cambio de registro ocurre directamente después de que se haya cambiado el puntero del registro actual.
El evento Acción posterior al registro ocurre directamente después de que se haya modificado el registro actual.
Las macros pueden interrumpir la ejecución del evento cuando devuelven un valor booleano: True permite que la ejecución del evento continúe y False detiene la ejecución del evento.
Los siguientes eventos se pueden interrumpir al devolver False:
Antes de la acción de grabado
Antes del cambio de un registro
Antes de enviar
Antes de la actualización
Rellenar parámetros