SpinGadget()

Syntaxe

Resultat = SpinGadget(#Gadget, X, Y, Largeur, Hauteur, Minimum, Maximum [, Options])
Description
Crée un gadget incrémentiel 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 Les valeurs minimales et maximales.
Options (optionnel) Peut être une combinaison de:
  #PB_Spin_ReadOnly: Le gadget n'est pas éditable, sa valeur ne peut être changée que par les flèches (pas supporté par Linux).
  #PB_Spin_Numeric : Le gadget va mettre à jour automatiquement le texte affiché, donc SetGadgetText() n'est pas nécessaire.

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 contrôler le gadget:
  GetGadgetState()    : Renvoie la valeur du curseur interne.
  SetGadgetState()    : Change la valeur du curseur interne.
  GetGadgetText()     : Renvoie le texte du gadget.
  SetGadgetText()     : Change le texte du gadget.
  GetGadgetAttribute() avec un des attributs suivants:
    #PB_Spin_Minimum: Renvoie la valeur minimale possible.
    #PB_Spin_Maximum: Renvoie la valeur maximale possible. 

  SetGadgetAttribute(): avec un des attributs suivants:

    #PB_Spin_Minimum: Change la valeur minimale possible.
    #PB_Spin_Maximum: Change la valeur maximale possible. 

  Les évènements suivants sont supportés par EventType():
    #PB_EventType_Change: L'utilisateur a changé le texte dans la zone d'édition.
    #PB_EventType_Up    : Le bouton 'Haut' a été pressé.
    #PB_EventType_Down  : Le bouton 'Bas' a été pressé.
  
  - SetGadgetColor() et GetGadgetColor() avec les valeurs 'TypeCouleur' suivantes:
    #PB_Gadget_FrontColor: couleur du texte 
    #PB_Gadget_BackColor : couleur du fond

Exemple

  If OpenWindow(0, 0, 0, 160, 70, "SpinGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    SpinGadget     (0, 20, 20, 100, 25, 0, 1000)
    SetGadgetState (0, 5) : SetGadgetText(0, "5")   ; définit la valeur initiale
    Repeat
      Evenement = WaitWindowEvent()
      If Evenement = #PB_Event_Gadget
        If EventGadget() = 0
          SetGadgetText(0,Str(GetGadgetState(0)))
        EndIf
      EndIf
    Until Evenement = #PB_Event_CloseWindow
  EndIf

Voir aussi

GetGadgetState(), SetGadgetState(), GetGadgetText(), SetGadgetText(), GetGadgetAttribute(), SetGadgetAttribute(), GetGadgetColor(), SetGadgetColor()

OS Supportés

Tous

<- ShortcutGadget() - Gadget Index - SplitterGadget() ->