Conteúdo

# Database Form Events

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

Para aceder a este comando...

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

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

Para ligar um evento a uma macro, comece por escrever uma macro que contenha todos os comandos a executar quando o evento ocorre. Em seguida, atribua esta macro ao respetivo evento, clicando no botão ... junto do evento correspondente. É apresentada a caixa de diálogo Atribuir macro , na qual pode selecionar a macro.

É possível configurar individualmente as seguintes ações, o que significa que é possível utilizar as suas próprias caixas de diálogo para representar uma ação:

1. Mostrar uma mensagem de erro,

2. Confirmar um processo de eliminação (para registos de dados),

3. Consultar parâmetros,

4. Verificar a entrada de dados ao guardar um registo de dados.

Por exemplo, é possível emitir um pedido de confirmação de eliminação, como, por exemplo, "Tem a certeza de que pretende eliminar o cliente xyz?", ao eliminar um registo de dados.

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.

Em seguida, são mostrados e descritos todos os eventos de um formulário que pode associar a uma macro:

## Antes da alteração do registo

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

## Antes de atualizar

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.

## Depois de atualizar

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

## Antes da reposição

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

Um formulário é restaurado se se verificar uma das seguintes condições:

1. O utilizador prime um botão (HTML) definido como um botão de reposição.

2. Um registo novo e vazio é criado num formulário associado a uma origem de dados. Por exemplo, no último registo, pode ser premido o botão Registo seguinte.

## Após reposição

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

## Antes de ação de registo

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 descarregar

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

## Antes de enviar

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

## Antes de recarregar

O evento Antes de recarregar ocorre antes de recarregar um formulário. O conteúdo de dados ainda não foi recarregado.

## Ao carregar

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

## Ao descarregar

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

## Ao recarregar

O evento Ao recarregar ocorre imediatamente após recarregar um formulário. O conteúdo de dados ainda não foi recarregado.

## Após a ação em registo

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

## Após alteração do registo

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

## Confirmar eliminação

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.

## Ocorreu um erro

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

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

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