ScrollAreaGadget()

Syntax

Ergebnis = ScrollAreaGadget(#Gadget, x, y, Breite, Höhe, ScrollBereichBreite, ScrollBereichHöhe, ScrollSchritt [, Flags])

Erstellt ein ScrollArea-Gadget (scrollbarer Bereich) innerhalb der aktuellen Gadgetliste.

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

Es ist sehr nützlich, wenn ein Gadget zu groß ist, um in die Fenster-Dimensionen zu passen, dann kann es in den ScrollArea-Bereich gelegt werden. Das gesamte Scrolling wird automatisch vom Gadget verwaltet. Dies ist ein Container-Gadget und dafür gedacht, ein oder mehrere Gadgets innerhalb seines Scroll-Bereiches zu haben. Sobald dieses Gadget erstellt wurde, werden alle nachfolgend Gadgets innerhalb des ScrollArea-Bereiches erstellt. Sobald alle benötigten Gadgets erstellt wurden, muss CloseGadgetList() aufgerufen werden, um zur vorherigen Gadgetliste zurückzukehren. OpenGadgetList() kann später verwendet werden, um weitere Gadgets während des Programmablaufs ("on-the-fly") zum Scroll-Bereich hinzuzufügen.

'ScrollBereichBreite' und 'ScrollBereichHöhe' sind die anfänglichen Dimensionen des im Gadget enthaltenen scrollbaren Bereichs und sollten größer als die 'Breite' und 'Höhe' des Gadgets sein. 'ScrollSchritt' ist die Anzahl an Pixel, um die beim Drücken des Schieberegler-Pfeils gescrollt wird. '#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_ScrollArea_Flat       : Flacher Rahmen 
  #PB_ScrollArea_Raised     : Erhabener Rahmen 
  #PB_ScrollArea_Single     : Einfach vertiefter Rahmen 
  #PB_ScrollArea_BorderLess : Ohne jeden Rahmen

Die folgenden Befehle können benutzt werden, um auf dem ScrollAreaGadget zu agieren:

GetGadgetAttribute(): mit einem der folgenden Attribute:

  #PB_ScrollArea_InnerWidth  : gibt die Breite (in Pixel) des enthaltenen scrollbaren Bereichs zurück.
  #PB_ScrollArea_InnerHeight : gibt die Höhe (in Pixel) des enthaltenen scrollbaren Bereichs zurück.

SetGadgetAttribute(): mit einem der folgenden Attribute:

  #PB_ScrollArea_InnerWidth  : ändert die Breite (in Pixel) des enthaltenen scrollbaren Bereichs.
  #PB_ScrollArea_InnerHeight : ändert die Höhe (in Pixel) des enthaltenen scrollbaren Bereichs.

Beispiel:

  If OpenWindow(0,0,0,305,140,#PB_Window_SystemMenu|#PB_Window_ScreenCentered,"ScrollAreaGadget") And CreateGadgetList(WindowID(0))
    ScrollAreaGadget(0, 10, 10,290,120, 375, 155, 30)
      ButtonGadget  (1, 10, 10,230, 30,"Button 1")
      ButtonGadget  (2, 50, 50,230, 30,"Button 2")
      ButtonGadget  (3, 90, 90,230, 30,"Button 3")
      TextGadget    (4,130,130,230, 20,"This is the content of a ScrollAreaGadget!",#PB_Text_Right)
      CloseGadgetList() 
    Repeat 
      Select WaitWindowEvent() 
        Case  #PB_Event_CloseWindow 
          End 
        Case  #PB_Event_Gadget 
          Select EventGadgetID()
            Case 1
              MessageRequester("Info","Button 1 was pressed!",#PB_MessageRequester_Ok)
            Case 2
              MessageRequester("Info","Button 2 was pressed!",#PB_MessageRequester_Ok)
            Case 3
              MessageRequester("Info","Button 3 was pressed!",#PB_MessageRequester_Ok)
          EndSelect
      EndSelect 
    ForEver 
  EndIf

Unterstützte OS

Windows, Linux, MacOS X