DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques au WEB / Fonctions de gestion des jauges
  • Fonctionnement
  • Equivalences
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
Lance un traitement navigateur relativement long et fait avancer une jauge via Ajax selon l'avancement de ce traitement.
Dans ce cas, le traitement navigateur est divisé en un ensemble de petits traitements navigateur. L'exécution de chaque petit traitement permet de faire avancer la jauge.
Remarque : Cette fonction peut être utilisée dans un site PHP ou AWP.
Exemple
// Code navigateur
JaugeExécute(JAUGE_SansNom1, MAJ_Jauge, 0, 100, 10)
// Code navigateur de la procédure appelée par la fonction JaugeExécute
PROCÉDURE MAJ_Jauge(nValeur)
// Traitement optionnel permettant de lancer un traitement serveur
AJAXExécute(TraitementServeur)
// Code navigateur
tabValeurs est un tableau de 6 chaînes
tabValeurs[1] = "image1.jpg"
tabValeurs[2] = "image2.jpg"
tabValeurs[3] = "image3.jpg"
tabValeurs[4] = "image4.jpg"
tabValeurs[5] = "image5.jpg"
tabValeurs[6] = "image6.jpg"
JaugeExécute(JAUGE_SansNom1, MAJ_Jauge, tabValeurs)
// Code navigateur de la procédure appelée par la fonction JaugeExécute
PROCÉDURE MAJ_Jauge(nValeur)
// Traitement optionnel permettant de lancer un traitement serveur
AJAXExécute(TraitementServeur)
Syntaxe

Modifier la jauge à l'aide d'une procédure lancée périodiquement Masquer les détails

JaugeExécute(<Champ Jauge> , <Procédure WLangage> , <Borne minimale> , <Borne maximale> [, <Pas>])
<Champ Jauge> : Nom de champ
Nom du champ Jauge à manipuler.
<Procédure WLangage> : Nom de procédure
Procédure WLangage en code navigateur appelée à chaque itération. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>(<Valeur>)

Le paramètre <Valeur> correspond à la position courante dans l'itération.
<Borne minimale> : Réel
Valeur minimale transmise à la procédure.
<Borne maximale> : Réel
Valeur maximale transmise à la procédure.
<Pas> : Réel optionnel
Pas de modification de la valeur entre chaque appel de la procédure. Par défaut, ce paramètre vaut 1.

Modifier la jauge à l'aide d'une procédure lancée pour chaque élément d'un tableau Masquer les détails

JaugeExécute(<Champ Jauge> , <Procédure WLangage> , <Tableau>)
<Champ Jauge> : Nom de champ
Nom du champ Jauge à manipuler.
<Procédure WLangage> : Nom de procédure
Procédure WLangage en code navigateur appelée pour chaque élément du tableau. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>(<Valeur>)

Le paramètre <Valeur> correspond à l'élément courant du tableau.
<Tableau> : Variable de type Tableau
Nom de la variable de type Tableau contenant les valeurs à transmettre à la procédure WLangage.
Remarques

Fonctionnement

En code navigateur, il n'est pas possible d'avoir un traitement navigateur exécuté en arrière-plan dans le contexte de la page. En effet, tout traitement bloque le rafraîchissement du navigateur et donc empêche le rafraîchissement d'une jauge.
La fonction JaugeExécute appelle périodiquement une procédure WLangage navigateur et provoque le rafraîchissement de la jauge entre chaque appel.
Un traitement long doit donc être découpé en plusieurs étapes. Ces étapes sont appelées une par une par la procédure WLangage navigateur. Si un traitement serveur doit être effectué, il peut être lancé par la fonction AJAXExécute utilisée dans le code de la procédure WLangage navigateur.
La fonction JaugeExécute est une fonction asynchrone : elle lance le traitement et se termine immédiatement. Donc au moment du retour de la fonction, le traitement long n'est probablement pas terminé.

Equivalences

La fonction JaugeExécute est équivalente aux codes suivants :
Première syntaxe :
POUR Valeur = <BorneMin> A <BorneMax> PAS <Pas>
<Procédure>(Valeur)
FIN
Seconde syntaxe :
POUR TOUT Valeur DE <Tableau>
<Procédure>(Valeur)
FIN
Attention : Ces codes sont synchrones et ne permettent donc pas le rafraîchissement de la jauge.
Classification Métier / UI : Code UI
Composante : WDJS.DLL
Version minimum requise
  • Version 16
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