Méthode base Sur événement base hôte

4D v16.3


$1 -> Méthode base Sur événement base hôte

Paramètre	Type	Description
$1	Entier long	Code d'événement

Description

La Méthode base Sur événement base hôte permet aux composants 4D d’exécuter du code lors de l’ouverture et de la fermeture de la base hôte.

Note : Pour des raisons de sécurité, l’exécution de cette méthode base doit être autorisée explicitement dans la base hôte pour qu’elle puisse être appelée. Pour plus d’informations sur ce point, reportez-vous au manuel Mode Développement.

La Méthode base Sur événement base hôte est exécutée uniquement dans les bases utilisées en tant que composants de bases hôtes (lorsqu’elle est autorisée dans les Propriétés de la base hôte). Elle est appelée lorsque des événements liés à l’ouverture et la fermeture de la base hôte se produisent.

Pour traiter un événement, vous devez tester la valeur du paramètre $1 à l’intérieur de la méthode, et la comparer à l’une des constantes suivantes, placées dans le thème Evénements de la base :

Constante	Type	Valeur	Comment
Sur après fermeture base hôte	Entier long	4	La Méthode base Sur fermeture de la base hôte vient de terminer son exécution
Sur après ouverture base hôte	Entier long	2	La Méthode base Sur ouverture de la base hôte vient de terminer son exécution
Sur avant fermeture base hôte	Entier long	3	La base hôte est en cours de fermeture. La Méthode base Sur fermeture de la base hôte n’a pas encore été appelée. La Méthode base Sur fermeture de la base hôte n’est pas appelée tant que la Méthode base Sur événement base hôte du composant est en exécution
Sur avant ouverture base hôte	Entier long	1	La base hôte vient juste d’être lancée. La Méthode base Sur ouverture de la base hôte n’a pas encore été appelée. La Méthode base Sur ouverture de la base hôte n’est pas appelée tant que la Méthode base Sur événement base hôte du composant est en exécution

Ce principe permet aux composants 4D de charger et de sauvegarder des préférences ou des états utilisateurs liés à l’exploitation de la base hôte.

Exemple

Exemple de structure type d’une méthode base sur événement base hôte :

     // Méthode base sur événement base hôte

 C_ENTIER LONG($1)

 Au cas ou

          :($1=Sur avant ouverture base hôte)

              // placer ici le code à exécuter avant le "Sur ouverture" de la base hôte

 

          :($1=Sur après ouverture base hôte)

              // placer ici le code à exécuter après le "Sur ouverture" de la base hôte

 

          :($1=Sur avant fermeture base hôte)

              // placer ici le code à exécuter avant le "Sur fermeture" de la base hôte

 

          :($1=Sur après fermeture base hôte)

              // placer ici le code à exécuter après le "Sur fermeture" de la base hôte

 Fin de cas