SpinGadget()

Syntax

Ergebnis = SpinGadget(#Gadget, x, y, Breite, Höhe, Minimum, Maximum [, Flags])

Erstellt ein SpinGadget in der aktuellen Gadgetliste.

Parameter

#Gadget	Eine Nummer, um das neue Gadget zu identifizieren. #PB_Any kann verwendet werden, um diese Nummer automatisch zu generieren.
x, y, Breite, Höhe	Die Position und die Abmessungen des neuen Gadgets.
Minimum, Maximum	Die Minimum- und Maximum-Werte für das Gadget.
Flags (optional)	Flags zum Verändern des Gadget-Verhaltens. Dies kann eine Kombination (verknüpft mit dem bitweisen '|' OR-Operator) der folgenden Konstanten sein: #PB_Spin_ReadOnly : Das StringGadget ist nicht editierbar, die Nummer ist nur über die Pfeile änderbar (nicht verfügbar auf Linux). #PB_Spin_Numeric : Das SpinGadget wird den Text automatisch mit dem aktuellen Wert des SpinGadgets-Status aktualisieren, womit SetGadgetText() nicht benötigt wird.

Rückgabewert

Gibt bei Erfolg einen Wert ungleich Null zurück, oder Null bei einem Fehler. Wenn #PB_Any als #Gadget Parameter verwendet wurde, dann beinhaltet der Rückgabewert bei Erfolg die automatisch generierte Gadget-Nummer.

Anmerkungen

Zu diesem Gadget kann mittels GadgetToolTip() eine 'Mini-Hilfe' hinzugefügt werden.

Die folgenden Befehle können zum Verwalten des SpinGadgets benutzt werden:

GetGadgetState(): Ermittelt den aktuellen Gadget-Wert.
SetGadgetState(): Ändert den aktuellen Gadget-Wert. Für das Anzeigen des neuen Werts ist jedoch trotzdem noch SetGadgetText() notwendig!
GetGadgetText(): Ermittelt den im Gadget enthaltenen Text.
SetGadgetText(): Ändert den im Gadget enthaltenen Text.
GetGadgetAttribute(): Mit einem der folgenden Attribute:

  #PB_Spin_Minimum   : Gibt den Minimal-Wert zurück.
  #PB_Spin_Maximum   : Gibt den Maximal-Wert zurück.

SetGadgetAttribute(): Mit einem der folgenden Attribute:

  #PB_Spin_Minimum   : Ändert den Minimal-Wert.
  #PB_Spin_Maximum   : Ändert den Maximal-Wert.

Die folgenden Ereignisse werden durch EventType() unterstützt:

  #PB_EventType_Change: Der Text im Eingabebereich wurde durch den Anwender geändert.
  #PB_EventType_Up    : Die 'Nach oben'-Taste wurde gedrückt.
  #PB_EventType_Down  : Die 'Nach unten'-Taste wurde gedrückt.

Dieses Gadget unterstützt die SetGadgetColor() und GetGadgetColor() Befehle mit den folgenden Werten als 'FarbTyp':

  #PB_Gadget_FrontColor: Textfarbe
  #PB_Gadget_BackColor : Hintergrundfarbe

Beispiel

  If OpenWindow(0, 0, 0, 140, 70, "SpinGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    SpinGadget     (0, 20, 20, 100, 25, 0, 1000)
    SetGadgetState (0, 5) : SetGadgetText(0, "5")   ; legt den Anfangswert fest
    Repeat
      Event = WaitWindowEvent()
      If Event = #PB_Event_Gadget
        If EventGadget() = 0
          SetGadgetText(0, Str(GetGadgetState(0)))
        EndIf
      EndIf
    Until Event = #PB_Event_CloseWindow
  EndIf

Siehe auch

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

Unterstützte OS

Alle