Kaydırmalı çerçeveler

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Bir ScrollingFrame, özelleştirilebilir tuval ve kaydırma çubukları ile yerleşik kaydırma etkileşimi ve kaydırmanın nasıl çalıştığını özelleştirmenin farklı yollarıyla birlikte gelir. ScrollingFrame, sınırlı bir alanda çok fazla bilgiyi görüntülemek için idealdir ve liste ve ızgara düzenleriyle iyi çalışır.

Bir sekmeli kategori çubuğu ve oyuncunun satın almayı düşünebileceği sihirli öğelerin listesini içeren ekran üzerindeki Örnek Kaydırmalı Çerçeve.

Tuval

Tuval, bir ScrollingFrame'in içerebileceği diğer GuiObjects için ana alanıdır. Kaydırma davranışı aşağıdaki senaryolarda otomatik olarak uyum sağlar:

Çerçeve AyarıSonuç
Çerçevenin CanvasSize yüksekliği, toplam Size.Y değerini aşacak şekilde daha yüksektir.Dikey kaydırma etkinleştirilir ve dikey bir kaydırma çubuğu görünür.
Çerçevenin CanvasSize genişliği, toplam Size.X değerini aşacak şekilde daha geniştir.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 ayarlandığında ve içeriğinin (çocuk GuiObjects) toplam yüksekliği, toplam Size.Y değerini aştığında.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 ayarlandığında ve içeriğinin (çocuk GuiObjects) toplam genişliği, toplam Size.X değerini aştığında.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 ofsetini pikseller cinsinden yansıtır ve kaydırma çubuklarının konumunu buna göre ayarlar. Bu özelliğin kaydırma çubukları görünmedikçe bir işlevi yoktur.

Kenarlıklar

Bir kaydırmalı çerçevenin 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 kadar uzanır ve kaydırma çubuğunun altında hafif bir içerik miktarını gizler. Tersine, VerticalScrollBarInset değeri Always veya ScrollBar olarak ayarlandığında, tuval ScrollBarThickness miktarı kadar içe girer, böylece tuval kaydırma çubuğu ile kenarlarına kadar uyumlu olur.

Kaydırma çubukları

Çerçevenin kaydırma çubukları, mevcut tuval konumunu yansıtır ve otomatik sürükleme ile kaydırma etkileşimi sağlar. Dikey kaydırma çubukları için, VerticalScrollBarPosition özelliği çubuğun konumunu tuvalin soluna veya sağına değiştirebilir, ancak yatay kaydırma çubukları yalnızca tuvalin altına yerleştirilebilir.

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 ters çevrilmiş 90°) görüntülenir.
  • MidImageTopImage ve BottomImage arasındaki alanı kapsar (yatay bir kaydırma çubuğu için ters çevrilmiş 90°).
  • 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 ters çevrilmiş 90°) görüntülenir.
Kaydırmalı bir çerçevenin kaydırma çubuğunu oluşturan üç görüntü varlık öğesini gösteren diyagram.

Her görüntü, ScrollBarThickness özelliğine dayanarak ö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 ScrollBarImageColor3 ve ScrollBarImageTransparency özellikleri aracılığıyla yapılabilir; bu özellikler kaydırma çubuğunun görüntü varlıklarını renklendirir ve saydamlığını değiştirir.

Elastiklik

Varsayılan olarak, ScrollingFrames, dokunmatik cihazlarda elastik kaydırma davranışı sergiler; bu, kullanıcıların tuvali sınırlarının ötesine biraz daha sürükleyebileceği ve bırakıldığında tuvalin minimum veya maksimum sınırına geri dönmesini sağlar. Elastik davranışı tamamen kaldırmak ve tuvalin sınırlarının ötesine kaymasına izin vermemek istiyorsanız, ElasticBehavior özelliğini Never olarak ayarlayın.

©2026 Roblox Corporation. Roblox, the Roblox logo and Powering Imagination are among our registered and unregistered trademarks in the U.S. and other countries.