ScrollBarGadget3D

ScrollBarGadget3D()

Syntax

Ergebnis = ScrollBarGadget3D(#Gadget3D, x, y, Breite, Höhe, Minimum, Maximum, SeitenLänge [, Flags])

Beschreibung

Erstellt ein ScrollBar-Gadget (Schiebebalken) innerhalb der aktuellen Gadgetliste. Es wird häufig verwendet, wenn nur ein Teil eines Objektes angezeigt wird.

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.

Minimum, Maximum Der Bereich an Werten, welche der Schiebebalken annehmen kann. Diese Werte sollten zwischen 0 und 10.000 liegen, um Einschränkungen auf manchen Betriebssystemen zu vermeiden.

SeitenLänge Der Wertebereich, der zur gerade dargestellten "Seite" gehört.

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 (optional)
Dies kann eine Kombination der folgenden Werte sein:
  #PB_ScrollBar3D_Vertical : Der Schiebebalken ist vertikal (anstelle von horizontal, was der Standard ist).

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

Zu diesem Gadget kann mittels GadgetToolTip3D() eine 'Mini-Hilfe' hinzugefügt werden.

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

- GetGadgetState3D(): Gibt die aktuelle Position des Schiebebalkens zurück (der Wert liegt innerhalb der Minimum-Maximum Spanne).
- SetGadgetState3D(): Ändert die aktuelle Schiebebalken-Position.
- GetGadgetAttribute3D(): Mit einem der folgenden Attribute:
  #PB_ScrollBar3D_Minimum   : gibt die minimale Schiebebalken-Position zurück.
  #PB_ScrollBar3D_Maximum   : gibt die maximale Schiebebalken-Position zurück.
  #PB_ScrollBar3D_PageLength: gibt den Wert der Seitenlänge zurück.
- SetGadgetAttribute3D(): Mit einem der folgenden Attribute:
  #PB_ScrollBar3D_Minimum   : ändert die minimale Schiebebalken-Position.
  #PB_ScrollBar3D_Maximum   : ändert die maximale Schiebebalken-Position.
  #PB_ScrollBar3D_PageLength: ändert den Wert der Seitenlänge.

Unterstützte OS

Alle

<- ScrollAreaGadget3D() - Gadget3D Inhaltsverzeichnis - SetActiveGadget3D() ->

#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.
Minimum, Maximum	Der Bereich an Werten, welche der Schiebebalken annehmen kann. Diese Werte sollten zwischen 0 und 10.000 liegen, um Einschränkungen auf manchen Betriebssystemen zu vermeiden.
SeitenLänge	Der Wertebereich, der zur gerade dargestellten "Seite" gehört. 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 (optional)	Dies kann eine Kombination der folgenden Werte sein: #PB_ScrollBar3D_Vertical : Der Schiebebalken ist vertikal (anstelle von horizontal, was der Standard ist).