ScrollBarGadget()

Syntax

Ergebnis = ScrollBarGadget(#Gadget, x, y, Breite, Höhe, Minimum, Maximum, SeitenLänge [, Flags])
Beschreibung
Erstellt ein ScrollBar-Gadget (Schiebebalken) innerhalb der aktuellen Gadgetliste.

Wenn #PB_Any als '#Gadget' Parameter verwendet wird, dann wird der Identifier des neuen Gadgets als 'Ergebnis' zurückgegeben.

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 'SeitenLänge' 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. '#Gadget' ist der numerische Bezeichner (Identifier), der (später) vom EventGadgetID() Befehl zurückgegeben wird.

'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 (Wert innerhalb der Minimum-Maximum Spanne) des Schiebebalkens zurück.
- SetGadgetState(): Ändert die aktuelle Schiebebalken-Position.

Beispiel:
  If OpenWindow(0,0,0,305,140,#PB_Window_SystemMenu|#PB_Window_ScreenCentered,"ScrollBarGadget") And CreateGadgetList(WindowID(0))
    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)   ; set 1st scrollbar (ID = 0) to 50 of 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)   ; set 2nd scrollbar (ID = 1) to 100 of 300
    Repeat : Until WaitWindowEvent()=#PB_Event_CloseWindow
  EndIf

Unterstützte OS

Windows, Linux, MacOS X

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