Conteúdo
Índice 🔎︎

# Eventos

O separador Eventos permite atribuir uma macro a determinados eventos que ocorram num formulário.

Para aceder a este comando...

Abra o menu de contexto de um elemento de formulário selecionado e escolha Formulário - Eventos.

Abra a barra de ferramentas Controlos de formulário ou a barra de ferramentas Design de formulário, clique no ícone Formulário , separador Eventos

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.

Os eventos mostrados na caixa de diálogo Eventos não podem ser editados diretamente. Pode eliminar um evento da lista premindo a tecla Del.

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 is changed. For example, the linked macro can prevent this action by returning "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. The linked macro can, for example, prevent this action by returning "FALSE".

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 is changed. 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.

## Antes de recarregar

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

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

The When reloading event occurs directly after the form has been reloaded. The data content has already been refreshed.

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

Aqui, :name corresponde a um parâmetro cujo preenchimento é obrigatório ao carregar. Se possível, o parâmetro é automaticamente preenchido a partir do formulário ascendente. Se o preenchimento do parâmetro não for possível, este evento é invocado e o parâmetro pode ser preenchido por uma macro associada.