Bir ScrollingFrame, özelleştirilebilir bir tuval ve yerleşik kaydırma etkileşimi ile kaydırma çubukları içerir ve kaydırmanın nasıl çalıştığını özelleştirmenin farklı yollarını sunar. ScrollingFrame, sınırlı bir alanda çok fazla bilgi görüntülemek için idealdir ve liste ve ızgara düzenleriyle iyi çalışır.
Tuval
Tuval, bir ScrollingFrame'in diğer GuiObjects'ı içerebilen ana alanıdır. Kaydırma davranışı aşağıdaki senaryolarda otomatik olarak uyum sağlar:
| Çerçeve Ayarı | Sonuç |
|---|---|
| Çerçevenin CanvasSize'ı toplam yüksekliğinden daha yüksektir; özellikle toplam CanvasSize.Y değeri toplam Size.Y değerini aşar. | Dikey kaydırma etkinleştirilir ve dikey bir kaydırma çubuğu görünür. |
| Çerçevenin CanvasSize'ı toplam genişliğinden daha geniştir; özellikle toplam CanvasSize.X değeri toplam Size.X değerini aşar. | Yatay kaydırma etkinleştirilir ve yatay bir kaydırma çubuğu görünür. |
| Çerçevenin AutomaticCanvasSize değeri Y veya XY olarak ayarlanmışsa ve içeriğinin (çocuk GuiObjects) toplam yüksekliği toplam Size.Y değerini aşarsa. | Dikey kaydırma etkinleştirilir ve dikey bir kaydırma çubuğu görünür. |
| Çerçevenin AutomaticCanvasSize değeri X veya XY olarak ayarlanmışsa ve içeriğinin (çocuk GuiObjects) toplam genişliği toplam Size.X değerini aşarsa. | Yatay kaydırma etkinleştirilir ve yatay bir kaydırma çubuğu görünür. |
CanvasPosition özelliği, tuvalin çerçeve içindeki mevcut konumsal kaymasını piksel cinsinden yansıtır ve kaydırma çubuklarının konumunu buna göre ayarlar. Bu özelliğin, kaydırma çubukları görünmüyorsa hiçbir işlevi yoktur.
Kenar Boşlukları
Bir kaydırma çerçevesinin CanvasSize değeri, VerticalScrollBarInset ve/veya HorizontalScrollBarInset özelliklerinden etkilenebilir. Aşağıdaki örnek diyagramda, dikey kaydırma yapan bir çerçeve %100 tuval genişliği kullanır. VerticalScrollBarInset değeri None (varsayılan) olarak ayarlandığında, tuval kaydırma çerçevesinin tam genişliğine uzanır ve kaydırma çubuğunun altında hafif bir içerik gizler. Buna karşılık, VerticalScrollBarInset ayarının Always veya ScrollBar olarak ayarlanması, tuvali ScrollBarThickness miktarı kadar içe alır, böylece tuval kaydırma çubuğuyla kenar kenara gelir.
Kaydırma çubukları
Çerçevenin kaydırma çubukları, mevcut tuval konumunu yansıtır ve otomatik sürükleyerek kaydırma etkileşimi sağlar. Dikey kaydırma çubukları için, VerticalScrollBarPosition özelliği çubuğun konumunu tuvalin soluna veya sağına geçirebilir, ancak yatay kaydırma çubukları yalnızca tuvalin altında konumlandırılabilir.
Kaydırma çubuğu yapısı üç varlık özelliğinden oluşur:
- TopImage — Dikey bir kaydırma çubuğunun üstünde veya yatay bir kaydırma çubuğunun solunda (yatay kaydırma çubuğu için 90° saat yönünün tersine döndürülmüş) görüntülenir.
- MidImage — TopImage ile BottomImage arasındaki alanı kaplar (yatay kaydırma çubuğu için 90° saat yönünün tersine döndürülmüş).
- BottomImage — Dikey bir kaydırma çubuğunun altında veya yatay bir kaydırma çubuğunun sağında (yatay kaydırma çubuğu için 90° saat yönünün tersine döndürülmüş) görüntülenir.
Her bir görüntü, ScrollBarThickness özelliğine göre ölçeklenir; bu özellik, dikey bir kaydırma çubuğunun genişliğini veya yatay bir kaydırma çubuğunun yüksekliğini değiştirir.
Ek görsel değişiklikler, çubuğun görüntü varlıklarını renklendiren ve opaklığını değiştiren ScrollBarImageColor3 ve ScrollBarImageTransparency özellikleri aracılığıyla yapılabilir.
Kırpma
By default, GuiObject containers clip their content (descendant GuiObjects) through the ClipsDescendants boolean. If you want descendants to appear outside of a container's bounds, simply set ClipsDescendants to false.
Importantly, StarterGui.ClipsDescendantsSupportsRotation must be true for clipping to work on rotated descendants (non‑zero Rotation) within the container. However, clipping by a rotated container (clipping container itself is rotated) or by rounded corners (UICorner) is not supported. If you need clipping on rotated or rounded containers, consider CanvasGroup.
Rotation = 0
Rotation = 10
Esneklik
Varsayılan olarak, ScrollingFrames, dokunmatik destekli cihazlarda elastik kaydırma davranışı sergiler; bu, kullanıcıların tuvali sınırlarından biraz daha ileri sürükleyebileceği ve bıraktıklarında tuvalin minimum veya maksimum sınırına geri döneceği anlamına gelir. Elastik davranışı tamamen kaldırmak ve tuvalin sınırlarını asla aşmamasını sağlamak istiyorsanız, ElasticBehavior özelliğini Never olarak ayarlayın.