ScrollAreaGadget3D()

Syntax

Ergebnis = ScrollAreaGadget3D(#Gadget3D, x, y, Breite, Hoehe, ScrollBereichBreite, ScrollBereichHoehe, ScrollSchritt)

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

Wenn #PB_Any als '#Gadget3D' Parameter verwendet wird, dann wird die Nummer 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. In diesem Fall 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 nachfolgenden Gadgets innerhalb des ScrollArea-Bereiches erstellt. Sobald alle benötigten Gadgets erstellt wurden, muss CloseGadgetList3D() aufgerufen werden, um zur vorherigen Gadgetliste zurückzukehren. OpenGadgetList3D() kann später verwendet werden, um weitere Gadgets während des Programmablaufs ("on-the-fly") zum Scroll-Bereich hinzuzufügen.

'ScrollBereichBreite' und 'ScrollBereichHoehe' 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. '#Gadget3D' ist die Nummer, die (später) vom EventGadget3D() Befehl zurückgegeben wird. Wenn der Anwender die Schiebebalken im Gadget bewegt, wird ein Ereignis für das Gadget empfangen.

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

GetGadgetAttribute3D(): mit einem der folgenden Attribute:

  #PB_ScrollArea3D_InnerWidth  : gibt die Breite (in Pixel) des enthaltenen scrollbaren Bereichs zurück.
  #PB_ScrollArea3D_InnerHeight : gibt die Höhe (in Pixel) des enthaltenen scrollbaren Bereichs zurück.
  #PB_ScrollArea3D_X           : gibt die aktuelle horizontale Scroll-Position (in Pixel) zurück.
  #PB_ScrollArea3D_Y           : gibt die aktuelle vertikale Scroll-Position (in Pixel) zurück.

SetGadgetAttribute3D(): mit einem der folgenden Attribute:

  #PB_ScrollArea3D_InnerWidth  : ändert die Breite (in Pixel) des enthaltenen scrollbaren Bereichs.
  #PB_ScrollArea3D_InnerHeight : ändert die Höhe (in Pixel) des enthaltenen scrollbaren Bereichs.
  #PB_ScrollArea3D_X           : ändert die aktuelle horizontale Scroll-Position (in Pixel).
  #PB_ScrollArea3D_Y           : ändert die aktuelle vertikale Scroll-Position (in Pixel).

Unterstützte OS

Alle