PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version : 19.0

  • 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 Widget Android
  • Timer et interactions de l'utilisateur : défilements, gestures, ...
WinDevWebDev - Code ServeurWebDev - Code NavigateurWinDev MobileEtats et RequêtesWindowsLinuxWindows MobileWindows PhoneWindows Store appsAndroidWidget AndroidiPhone/iPadJavaPHPAjaxCode Utilisateur (MCU)Langage ExterneHFSQLHFSQL Client/ServeurProcédures stockéesHyper File 5.5OLE DBODBCAccès Natifs
TimerSys (Fonction)
En anglais : TimerSys

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 MobileWindows Phone 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 MobileWindows Phone 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 MobileWindows Phone Cette fonction est désormais disponible pour les applications Windows Phone.

Versions 18 et supérieures
WinDevWinDev MobileWindows Store apps Cette fonction est désormais disponible en mode Windows Store apps.
WinDev MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
Nouveauté 18
WinDevWinDev MobileWindows Store apps Cette fonction est désormais disponible en mode Windows Store apps.
WinDev MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WinDevWinDev MobileWindows Store apps Cette fonction est désormais disponible en mode Windows Store apps.
WinDev MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
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).

Widget Android

Timer et Widget Android

L'affichage du dessin d'une fenêtre Widget est effectué par le processus qui gère l'écran d'accueil de l'appareil. Cet affichage n'est pas effectué en permanence.

Si une procédure appelée par la fonction TimerSys doit mettre à jour l'interface du Widget, elle doit forcer le rafraîchissement avec la fonction WidgetAffiche.

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 Exemple Didactique (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
WD Alarme Exemple Didactique (WinDev) : WD Alarme
[ + ] Cet exemple montre comment déclencher un message d'alerte dans la barre de titre de la fenêtre active (quelle que soit l'application).

Ce message peut éventuellement s'accompagner d'une alarme sonore.

Nous abordons les principaux thèmes suivants :
1/ Les fonctions systèmes (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 Exemple Didactique (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 Exemple unitaire (WinDev Mobile) : Gestion des timers
[ + ] Gestion des timers

Cet exemple didactique montre comment mettre en place un timer et permet de :
Démarrer un Timer
Exécuter un code à chaque appel du timer
Arrêter un timer
Pocket Chrono Exemple Pocket (WinDev Mobile) : Pocket Chrono
[ + ] Cet exemple montre comment réaliser un chronomètre pour un terminal mobile avec WinDev Mobile.
Dans cet exemple, un timer est utilisé pour afficher les aiguilles du chronomètre analogique, et pour afficher régulièrement le temps écoulé.
Gestion des timers Exemple unitaire (WebDev) : Gestion des timers
[ + ] Gestion des timers

Cet exemple didactique montre comment mettre en place un timer et permet de :
Démarrer un Timer
Exécuter un code à chaque appel du timer
Arrêter un timer

Composantes
WinDevEtats et Requêtes wd190vm.dll
Windows Mobile wp190vm.dll
Java wd190java.jar
Linux wd190vm.so
Android wd190android.jar
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire