|
|
|
|
|
|
|
|
|
|
- Evénements gérés par défaut
Evénements associés au projet
Evénements gérés par défaut WINDEV, WEBDEV et WINDEV Mobile gèrent par défaut les événements suivants (ordre d'apparition sous l'éditeur de code) : | | | Evénement | Conditions d'exécution |
|---|
| Initialisation | Exécuté lors du lancement de l'application. L'ordre d'exécution des événements au lancement d'une application (y compris lors d'un test) est le suivant :- Initialisation des composants "chargés au lancement de l'application".
- Initialisation des sous-composants(*).
- Initialisation des classes du composant.
- Initialisation des collections de procédures du composant.
- Initialisation du projet du composant(*).
- Initialisation des classes.
- Initialisation des collections de procédures.
- Initialisation du projet.
- Initialisation de la première fenêtre du projet ou de l'élément testé.
(*) L'événement "Initialisation" d'un composant est exécuté uniquement lorsque le composant utilise le même contexte d'exécution que le projet. Pour plus de détails sur les options de génération du composant, consultez Créer et générer un composant externe.
Si la fonction Utilise est exécutée, l'événement d'initialisation du projet est interrompu (toutes les lignes de code suivant la fonction Utilise ne seront pas exécutées).
Exemples
Quelques exemples d'utilisation de cet événement : | | Utilisé si le site est exécuté avec des sessions prélancées. Pour gérer les sessions prélancées, deux événements sont associés au projet : - l'événement "Initialisation du projet", exécuté avant l'arrivée de la requête sur le Serveur d'application WEBDEV. Ce code est exécuté lors du lancement de la session prélancée.
- l'événement "Initialisation lors d'une connexion à une session prélancée", exécuté lorsque le Serveur d'application WEBDEV traite la requête.
Attention : Certaines fonctions WLangage ne doivent pas être utilisées dans l'événement "Initialisation du projet". Elles doivent être déplacées dans l'événement "Initialisation lors d'une connexion à une session prélancée". | | Fermeture | Exécuté lors de la fermeture de l'application (par exemple lors de la fermeture de la dernière fenêtre de l'application par exemple).
L'ordre d'exécution des événements lors de la fermeture du projet est le suivant :- Fermeture du projet.
- Evénement de terminaison des collections de procédures.
- Evénement de terminaison des classes.
- Fermeture des composants (fermeture du projet du composant, puis de ses collections de procédures, puis de ses classes, et de ses sous-composants).
Cet événement ne sera pas exécuté :- Lors de l'exécution de la fonction FinProgramme avec le paramètre "Code de fermeture" non spécifié ou égal à "Faux".
- Lors de l'exécution de la fonction AppliContrôle avec le paramètre "Exécution fermeture du projet" non spécifié ou égal à "Faux".
| | Exécuté dans les cas suivants si l'application est en cours d'utilisation :- Lors de la fermeture de la session de l'utilisateur en cours.
- Lors de l'arrêt du système du poste en cours.
- Lors du redémarrage du poste en cours.
Dans ces cas, seul cet événement sera exécuté. Les événements de fermeture de projet et de terminaison des classes et des collections de procédures ne seront pas exécutés.
Remarque : Selon le système d'exploitation du poste en cours, le système d'exploitation tente d'arrêter violemment l'application après un certain temps.
Exemples
Quelques exemples d'utilisation de cet événement :- Libération des librairies chargées en mémoire grâce à la fonction DéchargeDLL (si des librairies ont été chargées en mémoire).
- Libération des classes, des objets OLE Automation et des tableaux dynamiques (mot-clé Libérer).
- Annulation des transactions en cours (fonction HTransactionAnnule).
- Fermeture des fichiers HFSQL (fonction HFerme).
- Envoi de messages d'information à d'autres postes (fonction SendMessage).
- Exécution de l'événement de fermeture du projet grâce à la fonction FinProgramme avec le paramètre "Code de fermeture" égal à "Vrai".
| | Evénement optionnel.Pour activer cet événement, sous le volet "Tests automatiques", dans le groupe "Tests", cliquez sur le bouton de regroupement (  ) et sélectionnez l'option "Activer le code de test automatique du projet". Pour désactiver cet événement, sous le volet "Tests automatiques", dans le groupe "Tests", cliquez sur le bouton de regroupement ( ) et sélectionnez l'option "Désactiver le code de test automatique du projet". Cet événement est exécuté avant le code d'initialisation du projet dans le cas d'un test automatique. Ce code permet de traiter certains cas particuliers où le test automatique peut être bloqué : ouverture d'une fenêtre dans le code d'initialisation du projet (fenêtre de paramétrage, fenêtre de licence, fenêtre de login personnalisée, ...). Le code de test automatique du projet permet d'utiliser par exemple la fonction PiloteFenêtre pour valider la fenêtre. | | Exécuté lorsque l'application passe en arrière-plan. Cet événement permet par exemple de sauvegarder les données. Remarque : Cet événement est exécuté APRES l'événement optionnel des fenêtres "Mise en arrière-plan de l'application depuis la fenêtre". | | Exécuté lorsque l'application est réactivée et passe au premier plan. Cet événement permet par exemple de rafraîchir les données affichées. Remarques : - Cet événement n'est pas exécuté au démarrage de l'application.
- Cet événement est exécuté AVANT l'événement optionnel des fenêtres "Mise au premier plan de l'application sur la fenêtre".
| | Exécuté dans les cas suivants : - Au lancement de l'application (après l'événement "Initialisation" du projet).
- Lors du changement de thème réalisé par programmation avec la fonction ChangeThème uniquement si la constante avecExécutionDeCode a été spécifiée.
- Lors du changement de thème automatiquement effectué par le système : modification des paramètres système, changement d'heure jour/nuit, activation/désactivation de l'économiseur de batterie, ...
Remarque : Cet événement est disponible uniquement si la gestion du thème sombre est activée. Pour plus de détails, consultez Gestion du thème sombre mobile. | | Exécuté au lancement du Serveur d'application WEBDEV et également au lancement d'une application.Remarque : Les tâches planifiées WEBDEV n'étant pas persistantes, cet événement permet d'ajouter des tâches planifiées WEBDEV par programmation (fonction ServeurAppliAjouteTâchePlanifiée). | | Exécuté lors de l'installation et lors de la mise à jour d'une application ou lors du déblocage d'une application. | | Exécuté lors de l'arrêt du serveur d'application WEBDEV. |
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|