Frame bergulir

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

A terdiri dari kanvas yang dapat disesuaikan dan bilah gulir dengan interaksi gulir bawaan dan cara berbeda untuk menyesuaikan cara gulir bekerja. ScrollingFrame ideal untuk menampilkan banyak informasi di ruang terbatas dan berfungsi dengan baik dengan daftar dan grid tata letak.

Example ScrollingFrame on the screen containing a tabbed category bar and a list of magical items for the player to consider purchasing.

Lempengan

Kanvas adalah area utama dari yang dapat berisi lainnya .Perilaku gulir secara otomatis beradaptasi dalam skenario berikut:

Pengaturan FrameHadiah
Frame CanvasSize lebih tinggi dari ketinggian keseluruhannya; secara khusus total CanvasSize.Y melebihi total Size.Y.Gulir vertikal diaktifkan dan bar gulir vertikal muncul.
Frame CanvasSize lebih lebar dari lebar keseluruhannya; secara khusus total CanvasSize.X melebihi total Size.X.Scroll horizontal diaktifkan dan bilah gulir horizontal muncul.
Frame AutomaticCanvasSize diatur ke Y atau XY dan ketinggian total kontennya (anak GuiObjects ) melebihi totalnya Size.Y .Gulir vertikal diaktifkan dan bar gulir vertikal muncul.
Frame AutomaticCanvasSize diatur ke X atau XY dan lebar total kontennya (anak GuiObjects ) melebihi total Size.X .Scroll horizontal diaktifkan dan bilah gulir horizontal muncul.

Properti CanvasPosition mencerminkan offset posisional saat ini dari kanvas dalam bingkai, dalam piksel, dan mengatur posisi bilah gulir sesuai.Perhatikan bahwa properti ini tidak melakukan apa pun jika bilah gulir tidak terlihat.

Inserasi

Frame bergulir CanvasSize mungkin dipengaruhi oleh properti VerticalScrollBarInset dan/atau HorizontalScrollBarInset .Dalam diagram contoh berikut, frame bergulir vertikal menggunakan lebar kanvas 100%.Dengan VerticalScrollBarInset diatur ke None ( default ), kanvas diperpanjang ke lebar penuh dari bilah gulir, menghalangi sedikit konten di bawah bilah gulir.Sebaliknya, pengaturan VerticalScrollBarInset dari keduanya, Always atau ScrollBar menyisipkan kanvas dengan jumlah ScrollBarThickness sehingga kanvas bertemu dengan bilah gulir.

Gulir bilah

Bilah gulir frame mencerminkan posisi kanvas saat ini dan memberikan interaksi seret otomatis .Untuk bilah gulir vertikal, properti VerticalScrollBarPosition mengubah posisi bilah ke kiri atau kanan kanvas, tetapi bilah gulir horizontal hanya dapat diposisikan di bawah kanvas.

Konstruksi bilah gulir terdiri dari tiga properti aset:

  • TopImage — Tampil di bagian atas bilah gulir vertikal, atau di sebelah kiri bilah gulir horizontal (berputar 90° ke kanan untuk bilah gulir horizontal).
  • MidImage — Meluas wilayah antara TopImage dan BottomImage (berputar 90° ke kanan untuk bilah gulir horizontal).
  • BottomImage — Tampil di bagian bawah bilah gulir vertikal, atau di sebelah kanan bilah gulir horizontal (berputar 90° ke kiri untuk bilah gulir horizontal).
Diagram showing the three image asset elements which construct a scrolling frame's scroll bar.

Setiap gambar diukur berdasarkan properti ScrollBarThickness yang mengubah lebar bilah gulir vertikal atau ketinggian bilah gulir horizontal.

Modifikasi visual tambahan dapat dilakukan melalui properti ScrollBarImageColor3 dan ScrollBarImageTransparency yang menwarnai aset gambar bar dan mengubah opasitasnya, masing-masing.

Elastisitas

Secara default, ScrollingFrames menampilkan perilaku gulir elastik pada perangkat yang dapat disentuh, artinya pengguna dapat menyeret kanvas sedikit lebih jauh dari batasnya dan, saat dirilis, kanvas akan kembali ke batas minimum atau maksimumnya.Jika Anda ingin menghapus perilaku elastis sepenuhnya dan memastikan kanvas tidak pernah meluncur melewati batasnya, atur properti ElasticBehavior ke Never.