FR 1. Prise en main

Ce chapitre sert à vous présenter comment mettre en place simplement une barre de progression.

Les étapes sont applicables pour les deux types de barres de progression.

Nous allons nous appuyer sur les valeurs par défaut des propriétés pour cet exemple. Libre à vous de consulter la liste des formules si vous souhaitez personnaliser votre barre pendant cette présentation.

La première étape consiste à ajouter à un formulaire un objet de type image. Celui va servir à accueillir la barre de progression. Vous pouvez ajouter d’autres objets image si vous voulez générer plusieurs barres de progression simultanément.

La deuxième étape nécessite de créer une instance, au choix lancer une des deux méthodes de création d’instances du composant (barre circulaire ou linéaire). Idéalement, l’objet retourné par la méthode de votre choix devrait être stocké dans la variable « Form », il est également conseillé de rajouter un niveau à l’objet « Form ». Par exemple, « Form.progressbar ».

Une fois réalisé, ajoutez le nom de votre objet de formulaire image à l’instance. Puis pour votre essai, nous vous proposons de modifier la valeur de la progression actuelle qui est par défaut 0 et d’activer les animations. Il ne vous reste plus qu’à lancer la formule « launch » correspondant pour générer votre barre de progression.

Répétez la deuxième étape pour chaque objet de formulaire image si vous en avez créé plusieurs (une instance par objet image).

Essayez également d’utiliser la formule permettant d’activer l’animation « barbershop ». N’oubliez pas de créer un bouton pour lancer la formule qui arrête cette animation (voir le chapitre : Formules de gestion de la barre de progression).

Extrait du code pour une barre de progression linéaire :

Form.mypb:=New object
Form.mypb:=New AJUI_ProgressBar

Form.mypb.PBActivateAnimation (True)
Form.mypb.PBPercentValue (60)
Form.mypb.PBPictFormObjName ("AJUI_BPPict_container")

Form.mypb.LaunchProgressBar ( )

Nous vous conseillons également de lancer les formulaires exemples avec les méthodes préfixées « HDI » du composant pour vous faire une idée du résultat graphique et découvrir quelques cas d’utilisation ou AJUI ProgressBar apporte une réelle valeur ajoutée.

AJUI_Progressbar classes

Depuis la V18R3, vous pouvez remplacer les instances retournée par New AJUI_CircularProgressBar et New AJUI_ProgressBar par l'appel des classes CircularProgressBar et ProgressBar. Les fonctions de ces deux classes utilisent les mêmes noms et les mêmes paramètres que pour les formules obtenable par l'ancienne méthode. Les valeurs par défaut sont également les mêmes.

La seule différence en terme de code se trouvent lors de la création de l'instance :

  //avec les formules
    $myCPB:=New AJUI_CircularProgressBar ()
    $myPB:=New AJUI_ProgressBar ()

  //avec les classes
    $myCPB:=AJUI_CircularProgressBar.new ()
    $myPB:=AJUI_ProgressBar.new ()