TrackBarGadget()

Syntax

Ergebnis = TrackBarGadget(#Gadget, x, y, Breite, Höhe, Minimum, Maximum [, Flags])
Beschreibung
Erstellt ein TrackBar Gadget in der aktuellen Gadgetliste. Es ermöglicht Ihnen die Auswahl eines Wertebereichs mit Hilfe eines Schiebereglers, wie er in verschiedenen Multimedia-Playern zu finden ist.

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 vom Gadget verwendeten Minimum- und Maximum-Werte. Diese Werte sollten zwischen 0 und 10.000 liegen, um Einschränkungen auf manchen Betriebssystemen zu vermeiden.
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_TrackBar_Ticks    : Stellt einen 'Tick' Marker an jedem Schritt dar.
  #PB_TrackBar_Vertical : Das TrackBar ist jetzt vertikal (anstelle von horizontal, was der Standard ist).

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 verwendet werden, um auf dieses Gadget zuzugreifen:

- GetGadgetState(): Gibt die aktuelle Regler-Position (Wert innerhalb der Minimum-Maximum Spanne) zurück.
- SetGadgetState(): Ändert die aktuelle Regler-Position.
- GetGadgetAttribute() mit einem der folgenden Attribute:
  #PB_TrackBar_Minimum   : Gibt den Minimum-Wert zurück.
  #PB_TrackBar_Maximum   : Gibt den Maximum-Wert zurück.
- SetGadgetAttribute() mit einem der folgenden Attribute:
  #PB_TrackBar_Minimum   : Ändert den Minimum-Wert.
  #PB_TrackBar_Maximum   : Ändert den Maximum-Wert.

Beispiel

  If OpenWindow(0, 0, 0, 320, 200, "TrackBarGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    TextGadget    (3, 10,  20, 250, 20,"TrackBar Standard", #PB_Text_Center)
    TrackBarGadget(0, 10,  40, 250, 20, 0, 10000)
    SetGadgetState(0, 5000)
    TextGadget    (4, 10, 100, 250, 20, "TrackBar Ticks", #PB_Text_Center)
    TrackBarGadget(1, 10, 120, 250, 20, 0, 30, #PB_TrackBar_Ticks)
    SetGadgetState(1, 3000)
    TextGadget    (5,  90, 180, 200, 20, "TrackBar Vertical", #PB_Text_Right)
    TrackBarGadget(2, 270, 10, 20, 170, 0, 10000, #PB_TrackBar_Vertical)
    SetGadgetState(2, 8000)
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Siehe auch

GetGadgetState(), SetGadgetState(), GetGadgetAttribute(), SetGadgetAttribute()

Unterstützte OS

Alle

<- TextGadget() - Gadget Inhaltsverzeichnis - TreeGadget() ->