ScrollAreaGadget3D()

Syntax

Ergebnis = ScrollAreaGadget3D(#Gadget3D, x, y, Breite, Höhe, ScrollBereichBreite, ScrollBereichHöhe, ScrollSchritt)
Beschreibung
Erstellt ein ScrollArea-Gadget (scrollbarer Bereich) innerhalb der aktuellen Gadgetliste.

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.

Parameter

#Gadget3D Eine Nummer zum Identifizieren des neuen 3D-Gadgets. #PB_Any kann verwendet werden, um diese Zahl automatisch zu generieren.
x, y, Breite, Höhe Die Position und Abmessungen des neuen Gadgets.
ScrollBereichBreite, ScrollBereichHöhe Die Abmessungen des im Gadget enthaltenen scrollbaren Bereichs. Diese können auch kleiner als die äußeren Abmessungen sein, in diesem Fall wird das Scrolling deaktiviert.
ScrollSchritt (optional) Die Anzahl an Pixel, um die beim Drücken der Schieberegler-Pfeile gescrollt wird.

Rückgabewert

Gibt im Erfolgsfall einen Wert ungleich Null zurück, andernfalls Null. Wenn #PB_Any als #Gadget3D Parameter verwendet wurde, dann enthält bei Erfolg der Rückgabewert die automatisch generierte Nummer.

Anmerkungen

Die folgenden Funktionen können verwendet werden, um auf das ScrollAreaGadget zuzugreifen:

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

<- ResizeGadget3D() - Gadget3D Inhaltsverzeichnis - ScrollBarGadget3D() ->