ScrollBarGadget()

Syntax

Ergebnis = ScrollBarGadget(#Gadget, x, y, Breite, Hoehe, Minimum, Maximum, SeitenLaenge [, Flags])
Beschreibung
Erstellt ein ScrollBar-Gadget (Schiebebalken) innerhalb der aktuellen Gadgetliste.

Wenn #PB_Any als '#Gadget' Parameter verwendet wird, dann wird die Nummer des neuen Gadgets als 'Ergebnis' zurückgegeben. '#Gadget' ist die Nummer, die (später) vom EventGadget() Befehl zurückgegeben wird.

Es wird häufig verwendet, wenn nur ein Teil eines Objektes angezeigt wird. Der 'Minimum' - 'Maximum' Bereich sollte zwischen 0 und 10.000 liegen. Die 'SeitenLaenge' ist der Wert, welcher eine Seite definiert. Zum Beispiel: Sie haben ein Bild mit einer Breite von 100 Pixel und Sie sehen nur 25 Pixel. Was Sie sehen, wird eine 'Seite' genannt - in diesem Beispiel ist die Seitenlänge 25, der Minimum-Wert beträgt 0 und der Maximum-Wert 100.

'Flags' sind optional und können sich aus einer oder mehreren der folgenden Konstanten (verknüpft mit dem '|' OR-Operator) zusammensetzen:
  #PB_ScrollBar_Vertical : Der Schiebebalken ist vertikal (anstelle von horizontal, was der Standard ist).
Zu diesem Gadget kann mittels GadgetToolTip() eine 'Mini-Hilfe' hinzugefügt werden.

Die folgenden Befehle können zum Verwalten dieses Gadgets verwendet werden:

- GetGadgetState(): Gibt die aktuelle Position des Schiebebalkens zurück (der Wert liegt innerhalb der Minimum-Maximum Spanne).
- SetGadgetState(): Ändert die aktuelle Schiebebalken-Position.
- GetGadgetAttribute(): Mit einem der folgenden Attribute:
  #PB_ScrollBar_Minimum   : gibt die minimale Schiebebalken-Position zurück.
  #PB_ScrollBar_Maximum   : gibt die maximale Schiebebalken-Position zurück.
  #PB_ScrollBar_PageLength: gibt den Wert der Seitenlänge zurück.
- SetGadgetAttribute(): Mit einem der folgenden Attribute:
  #PB_ScrollBar_Minimum   : ändert die minimale Schiebebalken-Position.
  #PB_ScrollBar_Maximum   : ändert die maximale Schiebebalken-Position.
  #PB_ScrollBar_PageLength: ändert den Wert der Seitenlänge.

Beispiel:

  If OpenWindow(0, 0, 0, 305, 140, "ScrollBarGadget", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    TextGadget       (2,  10, 25, 250,  20, "ScrollBar Standard  (start=50, page=30/100)",#PB_Text_Center)
    ScrollBarGadget  (0,  10, 42, 250,  20, 0, 100, 30)
    SetGadgetState   (0,  50)   ; wir setzen den ersten Schiebebalken (ID = 0) auf 50 von 100
    TextGadget       (3,  10,115, 250,  20, "ScrollBar Vertical  (start=100, page=50/300)",#PB_Text_Right)
    ScrollBarGadget  (1, 270, 10,  25, 120 ,0, 300, 50, #PB_ScrollBar_Vertical)
    SetGadgetState   (1, 100)   ; wir setzen den zweiten Schiebebalken (ID = 1) auf 100 von 300
    Repeat : Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

Unterstützte OS

Alle

<- ScrollAreaGadget() - Gadget Inhaltsverzeichnis - SetActiveGadget() ->