Conteúdo
Índice 🔎︎

# Eventos

Na página da aba Eventos, você pode vincular macros a eventos que ocorram nos campos de controle de um formulário.

Quando ocorre o evento, a macro vinculada é chamada. Para atribuir uma macro a um evento, pressione o botão .... A caixa de diálogo Atribuir ação abre.

Para acessar este comando...

Abra o menu de contexto do elemento de formulário selecionado e escolha a aba Propriedades do controle - Eventos.

Abra a barra de ferramentas Edição de formulário, clique no ícone Propriedades do controle - aba Eventos.

Dependendo do controle, diferentes eventos estarão disponíveis. Somente os eventos disponíveis para o controle e contexto selecionados estarão listados na página da aba Eventos.
Os eventos a seguir estão definidos:

## Ao aprovar ação

Esse evento ocorre antes de uma ação ser acionada por meio de um clique no controle. Por exemplo, um clique em um botão Enviar inicia uma ação de envio; no entanto, o processo de "envio" propriamente dito só será iniciado quando ocorrer o evento Ao iniciar. O evento Ao aprovar ação permite que você aborte o processo. Se o método atribuído retornar FALSO, o evento Ao iniciar não será executado.

## Ao executar ação

O evento Ao executar ação ocorre quando uma ação é iniciada. Por exemplo, se houver um botão Enviar no formulário, o processo de envio representa a ação a ser iniciada.

## Alterado

O evento Alterado ocorre quando o controle perde o foco e o conteúdo do controle mudou desde que perdeu o foco.

## Texto modificado

O evento Texto modificado ocorre quando você insere ou modifica um texto em um campo de entrada.

## Mudança no status do item

O evento Mudança no status do item ocorre se o status do campo de controle mudou, por exemplo, de marcado para desmarcado.

## Ao receber o foco

O evento Ao receber o foco ocorre se um campo de controle recebe o foco .

## Ao perder o foco

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

## Tecla pressionada

O evento Tecla pressionada ocorre quando o usuário pressiona qualquer tecla enquanto o controle detém o foco. Esse evento pode estar associado a uma macro de verificação de entradas.

## Tecla liberada

O evento Tecla liberada ocorre quando o usuário solta uma tecla enquanto o controle detém o foco.

## Mouse dentro

O evento Mouse dentro ocorre quando o mouse está dentro do campo de controle.

## Mouse movido durante pressionamento de tecla

O evento Mouse movido durante o pressionamento de tecla ocorre quando o mouse é arrastado ao pressionar uma tecla. Um exemplo é quando, durante a operação de arrastar e soltar, uma tecla adicional determina o modo (mover ou copiar).

## Mouse movido

O evento Mouse movido ocorre quando o mouse é movido sobre o controle.

## Botão do mouse pressionado

O evento Botão do mouse pressionado ocorre quando o botão do mouse é pressionado enquanto o ponteiro está ativado.

Note que este evento também é utilizado para notificar requerimentos para um menu de contexto do controle.

## Botão do mouse liberado

O evento Botão do mouse liberado ocorre quando o botão do mouse é liberado enquanto o ponteiro está ativado.

## Mouse fora

O evento Mouse fora ocorre quando o mouse está fora do campo de controle.

### Antes de atualizar

O evento Antes de atualizar ocorre antes que o conteúdo do controle alterado pelo usuário seja gravado na fonte de dados. A macro vinculada pode, por exemplo, retornar FALSO para impedir esta ação.

### Após atualizar

O evento Após atualizar ocorre depois que o conteúdo do controle alterado pelo usuário ser gravado na fonte de dados.

### Antes de redefinir

O evento Antes do reset ocorre antes do reset de um formulário. Ao retornar True aprova o reset e ao retornar False cancela a operação.

O formulário será redefinido se uma destas condições for atendida:

1. O usuário pressiona um botão (HTML), que é definido como um botão de redefinição.

2. Será criado um registro novo e vazio em um formulário que esteja vinculado a uma fonte de dados. Por exemplo, no último registro, é possível pressionar o botão Próximo registro.

### Após redefinição

O evento Após redefinição ocorrerá depois que um formulário for redefinido.