DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Editeurs / Editeur de projet
  • Evénements gérés par défaut
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
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énementConditions d'exécution
InitialisationExé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 :
WEBDEV - Code Serveur Initialisation du projet après connexion au site
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 du projet après connexion au site", 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 du projet après connexion au site".
Pour plus de détails, consultez Sessions prélancées.
FermetureExé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".
WINDEVWindowsLinux Fermeture de session
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".
WINDEVWindows
Test automatique
Evénement optionnel.
Pour activer cet événement, sous le volet "Tests automatiques", dans le groupe "Tests", cliquez sur le bouton de regroupement (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 (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.
AndroidiPhone/iPad Mise en arrière-plan
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".
AndroidiPhone/iPad Mise au premier plan
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".
AndroidiPhone/iPad Application du thème clair/sombre
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.
WEBDEV - Code Serveur Configuration de site : démarrage du Serveur d'application
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).
WEBDEV - Code Serveur Configuration de site : démarrage de l'application
Exécuté lors de l'installation et lors de la mise à jour d'une application ou lors du déblocage d'une application.
WEBDEV - Code Serveur Configuration de site : arrêt du Serveur d'application
Exécuté lors de l'arrêt du serveur d'application WEBDEV.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale