4D v14.3

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

Accueil

 
4D v14.3
Méthode base Sur événement base hôte

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


 

$1 -> Méthode base Sur événement base hôte 
Paramètre Type   Description
$1  Entier long in Code d'événement

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

 
PROPRIÉTÉS 

Produit : 4D
Thème : Méthodes base
Nom intl. : On Host Database Event database method

 
HISTORIQUE 

New
Créé : 4D v14

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)