Ein ScrollingFrame besteht aus einem anpassbaren Canvas und Scrollleisten mit eingebauter Scrollinteraktivität und verschiedenen Möglichkeiten, wie das Scrollen funktioniert, anzupassen. ScrollingFrame eignet sich ideal, um viel Information in einem begrenzten Raum anzuzeigen, und funktioniert gut mit Liste und Gitter布局.
Leinwand
Die Leinwand ist der primäre Bereich eines ScrollingFrame, der andere GuiObjects.Das Scrollverhalten passt sich automatisch in den folgenden Szenarien an:
| Rahmen-Einrichtung | Ergebnis |
|---|---|
| Die CanvasSize des Rahmens ist höher als seine Gesamthöhe; insbesondere überschreitet die Gesamtmenge CanvasSize.Y die Gesamtmenge Size.Y. | Vertikale Scrollen ist aktiviert und eine vertikale Scrollleiste erscheint. |
| Die Rahmenbreite von CanvasSize ist breiter als seine Gesamtbreite; insbesondere überschreitet die Gesamtbreite von CanvasSize.X die Gesamtbreite von Size.X. | Horizontales Scrollen ist aktiviert und eine horizontale Scrollleiste erscheint. |
| Die AutomaticCanvasSize des Rahmens ist auf Y oder XY eingestellt, und die Gesamthöhe seiner Inhalte (Kind GuiObjects ) überschreitet seine Gesamthöhe Size.Y. | Vertikale Scrollen ist aktiviert und eine vertikale Scrollleiste erscheint. |
| Die AutomaticCanvasSize des Rahmens ist auf X oder XY eingestellt, und die Gesamtbreite seiner Inhalte (Kind GuiObjects ) überschreitet seine Gesamtbreite Size.X. | Horizontales Scrollen ist aktiviert und eine horizontale Scrollleiste erscheint. |
Die Eigenschaft CanvasPosition widerspiegelt den aktuellen positionalen Versatz der Leinwand innerhalb des Rahmens, in Pixeln, und legt die Position der Scrollleisten entsprechend fest.Beachten Sie, dass diese Eigenschaft nichts tut, wenn die Scrollleisten nicht sichtbar sind.
Einsätze
Die Eigenschaften eines scrollenden Rahmens können durch die und/oder Eigenschaften beeinflusst werden.Im folgenden Beispieldiagramm verwendet ein vertikal scrollender Rahmen eine Breite der Leinwand von 100%.Mit VerticalScrollBarInset auf None (Standard) eingestellt, erweitert sich die Leinwand auf die volle Breite des Scrollrahmens und verschleiert eine leichte Menge an Inhalten unter der Scrollleiste.Im Gegensatz dazu füllt ein VerticalScrollBarInset -Einstellung entweder Always oder ScrollBar die Leinwand mit der ScrollBarThickness -Menge auf, so dass die Leinwand randnah mit der Scrollleiste übereinstimmt.
Scrollleisten
Die Scrollleisten des Rahmens widerspiegeln die aktuelle Position der Leinwand und bieten automatische Ziehpunkte-Interaktivität.Für vertikale Scrollleisten wechselt die VerticalScrollBarPosition Eigenschaft die Position der Leiste entweder nach links oder rechts auf der Leinwand, aber horizontale Scrollleisten können nur unter der Leinwand platziert werden.
Die Bar scrollen besteht aus drei Asset-Eigenschaften:
- TopImage — Zeigt auf der Spitze einer vertikalen Scrollleiste oder links einer horizontalen Scrollleiste (gedreht um 90° im Uhrzeigersinn für eine horizontale Scrollleiste).
- MidImage — Deckt den Bereich zwischen TopImage und BottomImage (gedreht um 90° im Uhrzeigersinn für eine horizontale Scrollleiste).
- BottomImage — Zeigt auf der Unterseite einer vertikalen Scrollleiste oder rechts einer horizontalen Scrollleiste (gedreht um 90° im Uhrzeigersinn für eine horizontale Scrollleiste).
Jedes Bild wird basierend auf der Eigenschaft ScrollBarThickness skaliert, die die Breite einer vertikalen Scrollleiste oder die Höhe einer horizontalen Scrollleiste ändert.
Zusätzliche visuelle Änderungen können durch die Eigenschaften ScrollBarImageColor3 und ScrollBarImageTransparency vorgenommen werden, die das Bild der Bar-Assets tönen und ihre Opazität jeweils modifizieren.
Elastizität
Standardmäßig zeigt ScrollingFrames Aussteller ein elastisches Scrollverhalten auf touch-aktivierten Geräten, was bedeutet, dass Benutzer die Leinwand leicht weiter als ihre Grenzen ziehen können und nach der Freigabe die Leinwand auf ihre minimale oder maximale Grenze zurückprallt.Wenn du das elastische Verhalten vollständig entfernen und sicherstellen möchtest, dass die Leinwand nie über ihre Grenzen scrollt, lege die ElasticBehavior Eigenschaft auf Never fest.