Contenu
Index 🔎︎

# Événements de formulaires de base de données

L'onglet Événements permet d'assigner une macro à certains événements se produisant dans un formulaire.

Pour accéder à cette commande...

Ouvrez le menu contextuel d'un élément de formulaire sélectionné, choisissez l'onglet Propriétés du contrôle - Événements.

Ouvrez la barre d'outils Ébauche de formulaire, cliquez sur l'icône Propriétés du formulaire - onglet Événements.

Pour lier un événement à une macro, écrivez d'abord une macro contenant toutes les commandes devant être déclenchées par l'événement. Assignez ensuite cette macro à l'événement correspondant en cliquant sur le bouton ... situé en regard de cet événement. La boîte de dialogue Assignation de macro s'ouvre. Vous pouvez y sélectionner la macro.

Il est possible pour l'utilisateur de configurer librement les actions suivantes, c'est-à-dire que vous pouvez utiliser des boîtes de dialogue personnalisées pour représenter une action :

1. Affichage d'un message d'erreur,

2. Confirmation de la suppression (d'enregistrements),

3. Demande de confirmation de paramètres,

4. Vérification des entrées lors de la sauvegarde d'un enregistrement.

Par exemple, vous pouvez formuler une requête "confirmation de suppression" telle que "Êtes-vous sûr de vouloir supprimer le client xyz ?" qui sera déclenchée par l'utilisation de la fonction de suppression d'un enregistrement de données.

Les événements qui sont affichés dans la boîte de dialogue Événements ne peuvent pas être édités directement. Vous pouvez supprimer un événement de la liste en appuyant sur la touche Suppr.

La liste suivante décrit tous les événement d'un formulaire pouvant être liés à une macro :

## Après l'action d'enregistrement

L'événement Après l'action d'enregistrement se produit directement après la modification de l'enregistrement actif.

## Après le changement d'enregistrement

L'événement Après le changement d'enregistrement se produit directement après la modification du pointeur de l'enregistrement actif.

## Avant l'action d'enregistrement

L'événement Avant l'action d'enregistrement survient avant que l'enregistrement actif ou le jeu d'enregistrement soit modifié. Renvoyez Vrai lorsque la modification est permise, Faux sinon. Par exemple, les macros liées peuvent demander une boîte de dialogue de confirmation.

## Avant la mise à jour

L'événement Avant l'actualisation se produit avant que le contenu du contrôle modifié par l'utilisateur ne soit écrit dans la source de données. Par exemple, la macro liée peut empêcher cette action en renvoyant la valeur FALSE.

## Après la mise à jour

L'événement Après l'actualisation se produit après que le contrôle modifié par l'utilisateur a été écrit dans la source de données.

## Avant de rétablir

L'événement Avant de rétablir se produit avant que le formulaire soit rétabli. Renvoyer Vrai approuve le rétablissement, renvoyer False annule l'opération.

Un formulaire est rétabli lorsque l'une des conditions suivantes est remplie :

1. L'utilisateur appuie sur un bouton (HTML) défini comme bouton Rétablir.

2. Un enregistrement nouveau et vide est créé dans un formulaire lié à une source de données. Par exemple, dans le dernier enregistrement, vous devez cliquer sur le bouton Enregistrement suivant.

## Après le rétablissement

L'événement Après le rétablissement se produit après qu'un formulaire a été rétabli.

## Avant le changement d'enregistrement

L'événement Avant le changement d'enregistrement se produit avant que le pointeur d'enregistrement actuel - curseur SQL - ne soit modifié. Renvoyez Vrai lorsque le déplacement est autorisé , sinon Faux.

## Avant le déchargement

L'événement Avant le déchargement se produit avant que le formulaire ne soit déchargé, autrement dit, séparé de sa source de données.

## Avant l'envoi

L'événement Avant l'envoi se produit avant que les données du formulaire soient envoyées. Renvoyer True approuve l'envoie, False l'arrête.

## Avant le rechargement

L'événement Avant le rechargement se produit avant que le formulaire ne soit rechargé. Le contenu des données n'a pas encore été actualisé.

## Confirmer la suppression

L'événement Confirmer la suppression survient aussitôt que les données ont été supprimées du formulaire. Renvoyez Vrai pour permettre la suppression de la ligne, Faux sinon. Par exemple, la macro liée peur demander une confirmation dans une boîte de dialogue.

## Lors du chargement

L'événement Lors du chargement se produit directement après que le formulaire a été chargé.

## Lors du déchargement

L'événement Lors du déchargement se produit directement après que le formulaire a été déchargé, autrement dit, séparé de sa source de données.

## Lors du rechargement

L'événement Lors du rechargement se produit directement après que le formulaire a été rechargé. Le contenu des données a déjà été actualisé.

## Remplir les paramètres

L'événement Remplir les paramètres se produit lorsque le formulaire à charger contient des paramètres devant être remplis. Par exemple, la source de données du formulaire peut être la commande SQL suivante :

SELECT * FROM address WHERE name=:name

Ici :name est un paramètre qui doit être rempli lors du chargement. Ce paramètre est automatiquement rempli à partir du formulaire parent si possible. Si le paramètre ne peut pas être rempli, cet événement est appelé et une macro liée peut remplir le paramètre. Renvoyez Vrai quand l'exécution de l'instruction paramétrée doit se poursuivre, Faux sinon.

## Une erreur est survenue

L'événement Erreur survenue est activé sur une erreur survient lors de l'accès à la base de données. Ceci s'applique aux formulaire, zones de liste et zone combinées.

## Événements opposables

Les macros peuvent interrompre l'exécution de l'événement lorsqu'elles renvoient une valeur booléenne : True permet à l'exécution de l'événement de se poursuivre et False arrête l'exécution de l'événement.

Les événements suivants peuvent être interrompus en renvoyant False :

- Avant l'action d'enregistrement

- Avant le changement d'enregistrement

- Avant l'envoi

- Avant la mise à jour

- Remplir les paramètres