Módulo
Conteúdo
Índice 🔎︎

# Eventos

On the Events tab page you can link macros to events that occur in a form's control fields.

When the event occurs, the linked macro will be called. To assign a macro to an event, press the ... button. The Assign Action dialog opens.

Para aceder a este comando...

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

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

Depending on the control, different events are available. Only the available events for the selected control and context are listed on the Events tab page.
The following events are defined:

## Aprovar ação

This event takes place before an action is triggered by clicking the control. For example, clicking a "Submit" button initiates a send action; however, the actual "send" process is started only when the When initiating event occurs. The Approve action event allows you to kill the process. If the linked method sends back FALSE, When initiating will not be executed.

## Executar ação

The Execute action event occurs when an action is started. For example, if you have a "Submit" button in your form, the send process represents the action to be initiated.

## Alterado

The Changed event takes place when the control loses the focus and the content of the control has changed since it lost the focus.

## Texto modificado

The Text modified event takes place if you enter or modify a text in an input field.

## Estado do item alterado

The Item status changed event takes place if the status of the control field has changed.

## Ao receber foco

The When receiving focus event takes place if a control field receives the focus.

## Ao perder foco

O evento Ao perder foco ocorre se um campo de controlo perder o foco.

## Tecla premida

The Key pressed event occurs when the user presses any key while the control has the focus. This event may be linked to a macro for checking entries.

## Tecla largada

The Key released event occurs when the user releases any key while the control has the focus.

## Rato no interior

The Mouse inside event takes place if the mouse is inside the control field.

## Mover rato com a tecla premida

The Mouse moved while key pressed event takes place when the mouse is dragged while a key is pressed. An example is when, during drag-and-drop, an additional key determines the mode (move or copy).

## Mover rato

The Mouse moved event occurs if the mouse moves over the control.

## Botão do rato premido

The Mouse button pressed event occurs if the mouse button is pressed while the mouse pointer is on the control.

Tenha em atenção que este evento também é utilizado para notificar pedidos para um menu de contexto no controlo.

## Botão do rato solto

The Mouse button released event occurs if the mouse button is released while the mouse pointer is on the control.

## Rato no exterior

The Mouse outside event takes place when the mouse is outside the control field.

## Antes de atualizar

O evento Antes de atualizar ocorre antes do conteúdo do controlo alterado pelo utilizador ser escrito na origem de dados. A macro associada pode, por exemplo, impedir esta ação, devolvendo o valor "FALSE".

## Depois de atualizar

O evento Depois de atualizar ocorre após o conteúdo de controlo alterado pelo utilizador ter sido escrito na origem de dados.

## Antes da reposição

O evento Antes da reposição ocorre antes do restauro de um formulário. A macro associada pode, por exemplo, impedir esta ação, devolvendo o valor "FALSO".

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

O evento Após reposição ocorre após o restauro de um formulário.