ProgressBarGadget()

Syntaxe

Resultat = ProgressBarGadget(#Gadget, X, Y, Largeur, Hauteur, Minimum, Maximum [, Options])

Crée un gadget Barre de progression dans la GadgetList.

Arguments

#Gadget	Le numéro d'identification du nouveau gadget. #PB_Any peut être utilisé pour générer automatiquement ce numéro.
X, Y, Largeur, Hauteur	La position et les dimensions du nouveau gadget.
Minimum, Maximum	L'intervalle qui sera utilisé par la barre de progression. La valeur doit être comprise entre 0 et 65536 pour être compatible avec tous les systèmes d'exploitation.
Options (optionnel)	Peut être une combinaison de: #PB_ProgressBar_Smooth : La progression est précise, au lieu d'utiliser des blocs (Note: sous Windows XP avec le support des skins activé et sous OS X, cette option n'a aucun effet). #PB_ProgressBar_Vertical: La barre de progression sera verticale.

Valeur de retour

Renvoie une valeur non nulle en cas de succès, zéro sinon.

Si #PB_Any a été utilisé pour le paramètre #Gadget, alors la valeur de retour est le numéro d'identification du gadget, généré automatiquement.

Remarques

  - GadgetToolTip() permet d'ajouter une 'mini aide' à ce gadget. 

  Les fonctions suivantes peuvent être appelées pour agir sur la barre de progression :
  - SetGadgetState(): Change la valeur de la barre de progression. 
    #PB_ProgressBar_Unknown peut être utilisée pour indiquer que la progression est inconnue.

  - GetGadgetState(): Renvoie la valeur courante de la barre de progression.
  
  - SetGadgetAttribute() avec les attributs suivants:
    #PB_ProgressBar_Minimum: Change la valeur minimale.
    #PB_ProgressBar_Maximum: Change la valeur maximale. 

  - GetGadgetAttribute() avec les attributs suivants:
    #PB_ProgressBar_Minimum: Renvoie la valeur minimale.
    #PB_ProgressBar_Maximum: Renvoie la valeur maximale. 

  -SetGadgetColor() et GetGadgetColor() avec les valeurs suivantes comme 'TypeCouleur' 
  (Note: Sous Windows XP avec le support des skins activé, la couleur n'a aucun effet):
    #PB_Gadget_FrontColor: Couleur de la barre de progression
    #PB_Gadget_BackColor : Couleur du fond

  Note: SetGadgetColor() n'est pas pris en charge sur la plate-forme MacOS X.

Exemple

  If OpenWindow(0, 0, 0, 320, 160, "ProgressBarGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered) 
    TextGadget       (3,  10, 10, 250,  20, "Barre de progression standard  (50/100)", #PB_Text_Center)
    ProgressBarGadget(0,  10, 30, 250,  30, 0, 100)
    SetGadgetState   (0, 50)   ;  change la valeur de la 1ère barre de progression (ID = 0) à 50 sur 100
    TextGadget       (4,  10, 70, 250,  20, "Barre de progression précise  (50/200)", #PB_Text_Center)
    ProgressBarGadget(1,  10, 90, 250,  30, 0, 200, #PB_ProgressBar_Smooth)
    SetGadgetState   (1, 50)   ;  change la valeur de la 2ème barre de progression (ID = 1) à 50 sur 200
    TextGadget       (5, 100,135, 200,  20, "Barre de progression verticale  (100/300)", #PB_Text_Right)
    ProgressBarGadget(2, 270, 10,  30, 120, 0, 300, #PB_ProgressBar_Vertical)
    SetGadgetState   (2, 100)   ; change la valeur de la 3ème barre de progression (ID = 2) à 100 sur 300
    Repeat : Until WaitWindowEvent()=#PB_Event_CloseWindow
  EndIf

Voir aussi

GetGadgetState(), SetGadgetState(), GetGadgetAttribute(), SetGadgetAttribute(), GetGadgetColor(), SetGadgetColor(), SetGadgetItemImage()

OS Supportés

Tous