DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Jauge
  • Présentation
  • Faire varier la jauge
  • Jauge non symétrique (linéaires ou circulaires)
  • Jauge symétrique
  • Jauge non symétrique linéaire horizontale
  • Récupérer la position de la jauge
  • Modifier la position de la jauge
  • Propriétés spécifiques à la gestion d'un champ Jauge
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
Présentation
Un champ Jauge peut être manipulé directement par programmation. Il suffit d'utiliser directement la variable du champ Jauge dans le code.
La variable du champ Jauge :
  • correspond au nom du champ Jauge.
  • est initialisée avec la position de la jauge.
Faire varier la jauge
WINDEVWindowsUniversal Windows 10 AppAndroidiPhone/iPadJava

Jauge non symétrique (linéaires ou circulaires)

La progression se fait de la borne minimale à la borne maximale.
POUR I = JAUGE_Jauge1.BorneMin _À_ JAUGE_Jauge1.BorneMax
JAUGE_Jauge1 = I
FIN
WINDEVWindowsUniversal Windows 10 AppiPhone/iPad

Jauge symétrique

La progression se fait de la manière suivante :
POUR I = 2 * JAUGE_Jauge1.BorneMin - JAUGE_Jauge1.BorneMax _À_ JAUGE_Jauge1.BorneMax
JAUGE_Jauge1 = I
FIN
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHPAjax

Jauge non symétrique linéaire horizontale

Plusieurs méthodes permettent de faire varier une jauge en WEBDEV :
  • Méthode 1 : Effectuer le traitement correspondant à l'avancement de la jauge en code serveur. Le rafraîchissement de la jauge est effectué en code navigateur par la fonction JaugeActive.
    Attention : Ce code ne doit pas être effectué dans un traitement serveur en mode Ajax.
    Exemple :
    // -- Code serveur du bouton BTN_Traitement
    POUR I = JAUGE_SansNom1.BorneMin _À_ JAUGE_SansNom1.BorneMax
    JAUGE_SansNom1 = I
    Multitâche(-1)
    FIN

    // -- Code navigateur du bouton BTN_Traitement
    JaugeActive(JAUGE_SansNom1, 10)

    PHP Remarque : Cette méthode n'est pas disponible en PHP ou en AWP.
  • Méthode 2 (méthode pour les pages AWP) : Effectuer le traitement de la jauge en code navigateur grâce à la fonction JaugeExécute. Cette fonction appelle régulièrement une procédure WLangage Navigateur qui permet de gérer l'avancement de la jauge. Si un traitement serveur doit être effectué, il est nécessaire d'utiliser la fonction AjaxExécute dans la procédure navigateur.
    Attention : Pour afficher une jauge, un gros traitement serveur ou navigateur doit être découpé en plusieurs traitements. Cette méthode est conseillée pour des petits traitements répétitifs (par exemple, un traitement à réaliser pour un ensemble d'images).
    Exemple :
    // -- Code Navigateur
    JaugeExécute(JAUGE_1, MAJ_Jauge, 0, 100, 10)

    // Procédure navigateur appelée par la fonction JaugeExécute
    PROCÉDURE MAJ_Jauge(nValeur)
    // Code optionnel permettant de réaliser un traitement serveur
    AJAXExécute(TraitementServeur)

    PHP Remarque : Cette méthode est disponible en PHP et en AWP.
Remarque : Plusieurs fonctions permettent de manipuler une jauge dans une page WEBDEV. Pour plus de détails, consultez Fonctions de gestion des jauges.
Récupérer la position de la jauge
Pour récupérer la position d'une jauge, utilisez la syntaxe suivante :
<Position> = <Champ Jauge>
<Position> est une variable de type entier.
Remarque : Il est également possible d'utiliser la propriété Valeur.
Modifier la position de la jauge
Pour modifier la position d'une jauge, utilisez la syntaxe suivante :
<Champ Jauge> = <Valeur>
<Valeur> est une valeur comprise entre la valeur minimale et la valeur maximale de la jauge. Ces valeurs ont été décrites dans la fenêtre de description du champ ou par programmation, grâce aux propriétés BorneMin et BorneMax.
Remarque : Il est également possible d'utiliser la propriété Valeur.
Propriétés spécifiques à la gestion d'un champ Jauge
Les propriétés suivantes sont spécifiques à la gestion des caractéristiques d'un champ Jauge par programmation.
BorneMaxPermet de connaître et de modifier la borne maximale d'un champ Jauge.
BorneMinPermet de connaître et de modifier la borne minimale d'un champ Jauge.
CadrageHorizontalPermet de connaître et de modifier le cadrage horizontal du pourcentage de progression affiché dans le champ Jauge.
ImagePermet de connaître et de modifier l'image de progression d'un champ Jauge.
ImageFondPermet de connaître et de modifier l'image de fond d'un champ Jauge.
TexteJaugePermet de connaître ou de modifier le texte affiché dans un champ Jauge (au lieu du pourcentage).
VerticalPermet de savoir si le champ Jauge correspond à une jauge horizontale ou verticale.

Pour connaître la liste complète des propriétés du WLangage pouvant être utilisées avec un champ de type Jauge, consultez Propriétés associées au champ Jauge.
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