PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Différences entre les fonctions Timer et TimerSys
  • Traitement d'appel du timer
  • Opérations bloquantes ou non
  • Temps d'exécution de la procédure
  • Timer et fenêtres soeurs
  • Timer et Thread
  • Timer et service Windows
  • Timer et interactions de l'utilisateur : défilements, gestures, ...
Produits
WinDevWebDev - Code ServeurWebDev - Code NavigateurWinDev MobileEtats et Requêtes
Plateformes
WindowsLinuxWindows MobileUniversal Windows 10 AppAndroidWidget AndroidiPhone/iPadApple Watch
Langages
JavaPHPAjaxCode Utilisateur (MCU)Langage Externe
Bases de données
HFSQLHFSQL Client/ServeurProcédures stockéesOLE DBODBCAccès Natifs
Appelle périodiquement et automatiquement une procédure du WLangage. Utilisée dans la procédure, la fonction TimerSys permet d'identifier le timer qui a lancé la procédure.
On appelle timer la séquence d'appel périodique d'une procédure. Cet appel périodique sera stoppé grâce à la fonction FinTimerSys.
WinDevWinDev Mobile L'utilisation des procédures automatiques permet d'éviter l'utilisation de la fonction TimerSys. Pour plus de détails, consultez les procédures automatiques.
Versions 15 et supérieures
WinDev MobileAndroid Cette fonction est désormais disponible pour les applications Android.
Nouveauté 15
WinDev MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WinDev MobileAndroid Cette fonction est désormais disponible pour les applications Android.
Versions 16 et supérieures
WinDevLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 16
WinDevLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WinDevLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Versions 17 et supérieures
WinDev MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WinDev MobileUniversal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Nouveauté 17
WinDev MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WinDev MobileUniversal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
WinDev MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WinDev MobileUniversal Windows 10 App Cette fonction est désormais disponible pour les applications Windows Phone.
Versions 18 et supérieures
WinDevWinDev MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
WinDevWinDev MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
WinDevWinDev MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
WinDevWinDev MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WinDev MobileApple Watch Cette fonction est désormais disponible en mode Apple Watch.
Nouveauté 21
WinDevWinDev MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WinDev MobileApple Watch Cette fonction est désormais disponible en mode Apple Watch.
WinDevWinDev MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WinDev MobileApple Watch Cette fonction est désormais disponible en mode Apple Watch.
Exemple
// Procédure permettant l'affichage régulier de l'heure dans SAI_Heure1
PROCEDURE Affich_Heure()
SAI_Heure1 = HeureSys()

// Traitement à l'ouverture de la fenêtre
// Affich_heure sera appelée à chaque seconde
SI TimerSys("Affich_heure", 100, 1) = 0 ALORS
        Erreur("Création du timer impossible")
FIN
Syntaxe

Lancer périodiquement une procédure Masquer les détails

<Résultat> = TimerSys(<Nom de la procédure> , <Fréquence> [, <Numéro>])
<Résultat> : Entier
  • Numéro du timer ouvert (<Numéro> si ce paramètre a été précisé),
  • 0 si le timer n'a pas pu être ouvert.
<Nom de la procédure> : Chaîne de caractères
Nom de la procédure WLangage à lancer périodiquement.
<Fréquence> : Entier
Temps (en centièmes de seconde) entre deux appels à la procédure par timer. La précision de la fréquence dépend de l'état d'attente du système.
<Numéro> : Entier optionnel
Numéro imposé du timer. Si ce paramètre est précisé, le numéro du timer sera le numéro choisi. Si ce numéro correspond à un timer existant, il sera arrêté et remplacé par le nouveau timer.

Connaître le numéro du timer Masquer les détails

<Résultat> = TimerSys()
<Résultat> : Entier
Numéro du timer qui a appelé la procédure en cours.
Remarques

Différences entre les fonctions Timer et TimerSys

  • La fonction Timer permet d'utiliser un timer géré par WINDEV ou WINDEV Mobile. Dans ce cas, la fréquence d'appel est calculée à partir du moment où l'appel du timer a été effectué.
  • La fonction TimerSys permet d'utiliser un timer géré par le système. Dans ce cas, la fréquence d'appel est calculée à partir de l'instant de la fin de l'exécution de la procédure.
Conseil : Dans la majorité des cas, utilisez la fonction TimerSys.
En effet, la fonction Timer consomme plus de ressources que la fonction TimerSys et ne fonctionne que lorsque des fenêtres WINDEV/WINDEV Mobile sont en cours (le timer s'arrête si une boîte de message est affichée).

Traitement d'appel du timer

  • Code de projet :
    • Si la fonction TimerSys est appelée dans un code du projet, le timer est associé au projet. Le timer est interrompu par la fonction FinTimerSys et par la fin de l'exécution de l'application. La procédure appelée par le timer doit être :
      • soit une procédure globale du projet : TimerSys ("<procédure globale>", 1000)
      • soit une méthode statique d'une classe : TimerSys("<class>::<méthode statique>", 1000)
    • Si la fonction TimerSys est utilisée dans le traitement d'ouverture du projet et si aucune fenêtre n'est ouverte, le timer sera valide sur tout le projet. Il est en attente et sera déclenché automatiquement dès qu'une fenêtre sera ouverte ou lors des appels à la fonction Multitache.
  • Code d'une fenêtre, d'un champ ou d'une procédure local :
    Si la fonction TimerSys est appelée dans un code d'une fenêtre, d'un des champs de la fenêtre ou d'une procédure locale de la fenêtre, le timer est associé à la fenêtre. Le timer est interrompu par la fonction FinTimerSys et par la fermeture de la fenêtre. La procédure appelé par le timer doit être :
    • soit une procédure locale de la fenêtre : TimerSys("<procédure locale>", 1000)
    • soit une procédure globale du projet : TimerSys("<procédure globale>", 1000)
    • soit une méthode statique d'une classe : TimerSys("<class>::<méthode statique>", 1000)
  • Code d'une méthode statique de classe :
    Si la fonction TimerSys est appelée dans une méthode statique de classe, le timer est associé à la classe. Le timer est interrompu par la fonction FinTimerSys et par la fin d'exécution de l'application. La procédure appelée par le timer doit être :
    • soit une méthode statique de la classe : TimerSys("::<méthode statique>", 1000)
    • soit une méthode statique d'une autre classe : TimerSys("<class>::<méthode statique>", 1000)
    • soit une procédure globale du projet : TimerSys("<procédure globale>", 1000)
  • Code d'une méthode d'un objet :
    Si la fonction TimerSys est appelée dans une méthode d'un objet, le timer est associé à l'objet. Le timer est interrompu par la fonction FinTimerSys, par la libération de l'objet et par la fermeture de la fenêtre. La procédure appelée par le timer doit être :
    • soit une méthode non statique de l'objet : TimerSys("<:méthode>", 1000)
    • soit une méthode statique de la classe de l'objet : TimerSys("::<méthode statique>", 1000)
    • soit une méthode statique d'une autre classe : TimerSys("<class>::<méthode>", 1000)
    • soit une procédure globale du projet : TimerSys("<procédure globale>", 1000)

Opérations bloquantes ou non

  • Un timer n'est pas bloqué par l'ouverture des menus, l'ouverture d'une fenêtre, l'ouverture des fenêtres des fonctions Avertissement, Confirmer, Erreur, Info, OKAnnuler et OuiNon.
  • Un timer est bloqué par les déplacements et les agrandissements de fenêtres.

Temps d'exécution de la procédure

Si le temps de traitement de la procédure appelée par le timer est supérieur au temps demandé entre chaque appel de la procédure, les appels du timer ne s'empilent pas : il n'y aura qu'un seul appel en attente.
WinDevEtats et RequêtesJavaCode Utilisateur (MCU)

Timer et fenêtres soeurs

Dans le cas de l'ouverture multiple d'une même fenêtre gérant un timer (fenêtres soeurs dans un MDI), il faut utiliser la fonction TimerSys sans préciser le numéro de timer. Ainsi, un numéro de timer sera automatiquement attribué à chaque fenêtre.
WinDevEtats et RequêtesCode Utilisateur (MCU)

Timer et Thread

Une procédure lancée par les fonctions Timer ou TimerSys à partir d'un thread secondaire (fonction ThreadExécute) ne sera pas appelée. En effet, un thread secondaire n'a pas d'interface (c'est-à-dire pas de fenêtre ouverte) : ce thread secondaire ne reçoit pas les messages du système (la "boucle de message") comme le thread principal de l'application.
WinDev

Timer et service Windows

Pour utiliser la fonction TimerSys depuis un Service Windows, il est nécessaire d'appeler cette fonction à partir d'une fenêtre ouverte par le code du service.

Attention : Cette solution n'est pas conseillée. Pour répéter un traitement depuis un service, il est conseillé d'appeler ce traitement à partir du code du service (le code du service s'exécutant en boucle).
iPhone/iPad

Timer et interactions de l'utilisateur : défilements, gestures, ...

Les interactions de l'utilisateur (défilements, gestures) sont prioritaires sur les timers.
Par exemple, le défilement d'un champ Zone répétée sera bloquant pour l'exécution d'une procédure appelée par la fonction TimerSys.
Si une procédure doit être exécutée pendant les interactions de l'utilisateur, cette procédure doit être lancée par la fonction ThreadExécute.
Liste des exemples associés :
WD Ecran de veille Exemples didactiques (WINDEV) : WD Ecran de veille
[ + ] Cet exemple illustre la réalisation d'un économiseur d'écran avec les fonctions WLangage.
Dans cet exemple, nous abordons les principaux thèmes suivants :
1/ l'appel périodique d'une procédure (les "timers")
2/ la gestion des événements Windows
3/ les fonctions système (appel d'API Windows)
Pour utiliser l'écran de veille :
- Renommer l'exécutable (.EXE) en .SCR
- Copier le fichier dans le répertoire de Windows (Ex: C:\WINDOWS)
- Ouvrir la fenêtre de propriétés d'affichage du bureau
- Choisir l'onglet "Ecran de Veille"
- Sélectionnez l'écran de veille généré avec WINDEV
Les alarmes Exemples unitaires (WINDEV) : Les alarmes
[ + ] Mise en place d'une alarme pour afficher un message d'alerte dans la barre de titre de la fenêtre active (quelle que soit l'application).

Nous abordons les principaux thèmes suivants :
1/ Les fonctions système (récupération du handle d'une fenêtre)
2/ Le déclenchement d'un traitement selon une fréquence donnée (les timers)
WD Qui bloque Exemples didactiques (WINDEV) : WD Qui bloque
[ + ] Cet exemple montre comment signaler aux utilisateurs d'une base de données HFSQL en réseau "qui" bloque un enregistrement inaccessible.

Dans cet exemple, nous abordons les principaux thèmes suivants :
1/ la gestion des accès concurrentiels
2/ le rafraîchissement automatique par timer
3/ la gestion d'un fichier "système" pour mémoriser des informations sur les verrous posés.

Résumé de l'exemple livré avec WINDEV :
Cet exemple réalisé avec WINDEV est composé de 2 projets :
- WD Qui bloque : application de test gérant un fichier "client" en réseau
- WD Superviseur blocages : outil d'aministration pour visualiser les verrous posés et éventuellement forcer un déblocage.
Un utilisateur peut avoir conservé une fiche de saisie ouverte depuis un certain temps ; ce qui risque de gêner les autres utilisateurs.
Le bouton 'Libérez SVP' permet d'envoyer un message à l'utilisateur concerné pour lui demander de libérer l'enregistrement.
Le bouton 'Débloquer !' permet de forcer le déblocage de l'enregistrement.
Attention : Cette opération va envoyer un message forçant la fermeture de l'application ayant effectué le blocage.
Gestion des timers Exemples unitaires (WINDEV Mobile) : Gestion des timers
[ + ] Mise en place d'un timer :
- démarrer un timer
- exécuter un code à chaque appel du timer
- arrêter un timer
Les fonctions Chrono Exemples unitaires (WINDEV Mobile) : Les fonctions Chrono
[ + ] Utilisation des fonctions WLangage "Chrono".
Ces fonctions permettent de calculer le temps écoulé entre le début (Fonction ChronoDébut) et la fin (Fonction ChronoFin)
Android Inventaire Android (WINDEV Mobile) : Android Inventaire
[ + ] Cette application permet de réaliser les inventaires et d'enregistrer les résultats dans une base de données.
Gestion des timers Exemples unitaires (WEBDEV) : Gestion des timers
[ + ] Mise en place d'un timer :
- Démarrage d'un timer
- Exécution d'un code à chaque appel du timer
- Arrêt d'un timer
Composantes
WinDevEtats et Requêtes wd210vm.dll
Windows Mobile wp210vm.dll
Java wd210java.jar
Linux wd210vm.so
Android wd210android.jar
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire