Ein ScrollingFrame besteht aus einem anpassbaren Bereich und Bildlaufleisten mit integrierter Bildlaufinteraktivität und verschiedenen Möglichkeiten zur Anpassung der Bildlaufweise. ScrollingFrame eignet sich hervorragend zur Anzeige vieler Informationen auf engem Raum und funktioniert gut mit Listen und Raster Layouts.
Bereich
Der Bereich ist der Hauptbereich eines ScrollingFrame, der andere GuiObjects enthalten kann. Das Bildlaufverhalten passt sich automatisch in den folgenden Szenarien an:
| Rahmen Einrichten | Ergebnis |
|---|---|
| Die CanvasSize des Rahmens ist höher als seine Gesamthöhe; insbesondere überschreitet die gesamte CanvasSize.Y die gesamte Size.Y. | Vertikales Scrollen ist aktiviert und eine vertikale Bildlaufleiste erscheint. |
| Die CanvasSize des Rahmens ist breiter als seine Gesamtbreite; insbesondere überschreitet die gesamte CanvasSize.X die gesamte Size.X. | Horizontal scrolling is enabled and a horizontal scroll bar appears. |
| Die AutomaticCanvasSize des Rahmens ist auf Y oder XY eingestellt und die gesamte Höhe seines Inhalts (Kind GuiObjects) überschreitet die gesamte Size.Y. | Vertikales Scrollen ist aktiviert und eine vertikale Bildlaufleiste erscheint. |
| Die AutomaticCanvasSize des Rahmens ist auf X oder XY eingestellt und die gesamte Breite seines Inhalts (Kind GuiObjects) überschreitet die gesamte Size.X. | Horizontal scrolling is enabled and a horizontal scroll bar appears. |
Die CanvasPosition Eigenschaft spiegelt den aktuellen Positionsversatz des Bereichs innerhalb des Rahmens in Pixeln wider und legt die Position der Bildlaufleisten entsprechend fest. Beachten Sie, dass diese Eigenschaft nichts bewirkt, wenn die Bildlaufleisten nicht sichtbar sind.
Abstände
Die CanvasSize eines Bildlaufrahmens kann von den Eigenschaften VerticalScrollBarInset und/oder HorizontalScrollBarInset beeinflusst werden. Im folgenden Beispieldiagramm verwendet ein vertikal scrollender Rahmen eine Bereichsbreite von 100%. Mit VerticalScrollBarInset, das auf None (Standard) eingestellt ist, erstreckt sich der Bereich bis zur vollen Breite des Bildlaufrahmens und verdeckt einen kleinen Teil des Inhalts unter der Bildlaufleiste. Im Gegensatz dazu wird mit einer Einstellung von VerticalScrollBarInset entweder auf Always oder ScrollBar der Bereich um die ScrollBarThickness Menge eingeklemmt, sodass der Bereich randlos zur Bildlaufleiste angrenzt.
Bildlaufleisten
Die Bildlaufleisten des Rahmens spiegeln die aktuelle Bereichsposition wider und bieten eine automatische Drag-to-Scroll-Interaktivität. Für vertikale Bildlaufleisten wechselt die VerticalScrollBarPosition Eigenschaft die Position der Leiste entweder links oder rechts vom Bereich, während horizontale Bildlaufleisten nur unter dem Bereich positioniert werden können.
Der Bau der Bildlaufleisten besteht aus drei Asset-Eigenschaften:
- TopImage — Wird an der Spitze einer vertikalen Bildlaufleiste oder links von einer horizontalen Bildlaufleiste (um 90° gegen den Uhrzeigersinn gedreht für eine horizontale Bildlaufleiste) angezeigt.
- MidImage — Spannt den Bereich zwischen TopImage und BottomImage (um 90° gegen den Uhrzeigersinn gedreht für eine horizontale Bildlaufleiste).
- BottomImage — Wird am Boden einer vertikalen Bildlaufleiste oder rechts von einer horizontalen Bildlaufleiste (um 90° gegen den Uhrzeigersinn gedreht für eine horizontale Bildlaufleiste) angezeigt.
Jedes Bild skaliert basierend auf der ScrollBarThickness Eigenschaft, die die Breite einer vertikalen Bildlaufleiste oder die Höhe einer horizontalen Bildlaufleiste verändert.
Zusätzliche visuelle Modifikationen können durch die Eigenschaften ScrollBarImageColor3 und ScrollBarImageTransparency vorgenommen werden, die die Bild-Assets der Leiste einfärben und die Opazität verändern.
Elastizität
Standardmäßig zeigen ScrollingFrames elastisches Scrollverhalten auf berührungsempfindlichen Geräten, was bedeutet, dass Benutzer den Bereich etwas weiter als seine Grenzen ziehen können und nach dem Loslassen der Bereich zu seinem Mindest- oder Höchstwert zurückspringt. Wenn Sie das elastische Verhalten vollständig entfernen und sicherstellen möchten, dass der Bereich niemals über seine Grenzen scrollt, setzen Sie die ElasticBehavior Eigenschaft auf Never.