ScrollingFrame

Tampilkan yang Tidak Digunakan Lagi

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

ScrollingFrame adalah jenis khusus Frame dengan interaksi geser bawaan dan cara berbeda untuk menyesuaikan cara geser bekerja.

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

Rangkuman

Properti

AbsoluteCanvasSize:Vector2
Hanya Baca
Tidak Direplikasi
Ukuran area yang dapat discroll, dalam offset.
AbsoluteWindowSize:Vector2
Hanya Baca
Tidak Direplikasi
Ukuran frame, dalam offset, tanpa bilah gulir.
AutomaticCanvasSize:Enum.AutomaticSize
Baca Paralel
Menentukan apakah ScrollingFrame.CanvasSize diubah ukurannya berdasarkan konten anak.
BottomImage:ContentId
Baca Paralel
Gambar yang ditampilkan di bagian bawah bilah gulir vertikal, atau di sebelah kanan bilah gulir horizontal (berputar 90° ke kanan untuk bilah gulir horizontal).
CanvasPosition:Vector2
Baca Paralel
Mencerminkan offset posisi saat ini dari kanvas dalam bingkai, dalam piksel, dan mengatur posisi bilah gulir sesuai dengan itu.
CanvasSize:UDim2
Baca Paralel
Menentukan ukuran area yang dapat discroll.
ElasticBehavior:Enum.ElasticBehavior
Baca Paralel
Menentukan apakah dan kapan geser elastik diizinkan pada perangkat yang dapat disentuh.
HorizontalScrollBarInset:Enum.ScrollBarInset
Baca Paralel
Menunjukkan apakah CanvasSize adalah dimasukkan oleh ScrollBarThickness di sumbu horizontal.
MidImage:ContentId
Baca Paralel
Gambar yang meluas di antara TopImage dan BottomImage (berputar 90° searah kanan untuk bilah gulir horizontal).
ScrollBarImageColor3:Color3
Baca Paralel
Menentukan bagaimana gambar bilah gulir yang diterjemahkan diwarnai.
ScrollBarImageTransparency:number
Baca Paralel
Menentukan opasitas gambar bilah gulir.
ScrollBarThickness:number
Baca Paralel
Ketebalan bilah gulir dalam piksel; berlaku untuk bilah gulir horizontal dan vertikal.
ScrollingDirection:Enum.ScrollingDirection
Baca Paralel
Menentukan arah (atau) di mana gulir diizinkan.
ScrollingEnabled:boolean
Baca Paralel
Menentukan apakah geser diizinkan di frame.
TopImage:ContentId
Baca Paralel
Gambar yang ditampilkan di bagian atas bilah gulir vertikal, atau di sebelah kiri bilah gulir horizontal (berputar 90° ke kanan untuk bilah gulir horizontal).
VerticalScrollBarInset:Enum.ScrollBarInset
Baca Paralel
Menunjukkan apakah CanvasSize terletak di dalam oleh ScrollBarThickness pada sumbu vertikal.
VerticalScrollBarPosition:Enum.VerticalScrollBarPosition
Baca Paralel
Menunjukkan apakah bilah gulir vertikal di posisi kiri atau kanan kanvas.

Properti diwarisi dari GuiObject

Active:boolean
Baca Paralel
Menentukan apakah elemen UI ini menenggelamkan input.
AnchorPoint:Vector2
Baca Paralel
Menentukan titik asal dari GuiObject , relatif terhadap ukuran absolutnya.
AutomaticSize:Enum.AutomaticSize
Baca Paralel
Menentukan apakah penyesuaian ulang terjadi berdasarkan konten anak.
BackgroundColor3:Color3
Baca Paralel
Menentukan warna latar belakang GuiObject.
BackgroundTransparency:number
Baca Paralel
Menentukan transparansi latar belakang dan border GuiObject .
BorderColor3:Color3
Baca Paralel
Menentukan warna border GuiObject .
BorderMode:Enum.BorderMode
Baca Paralel
Menentukan dengan cara apa perbatasan GuiObject diletakkan relatif terhadap dimensinya.
BorderSizePixel:number
Baca Paralel
Menentukan lebar piksel dari batas GuiObject .
ClipsDescendants:boolean
Baca Paralel
Menentukan apakah keturunan GuiObjects di luar batas elemen GUI orangtua harus ditampilkan.
GuiState:Enum.GuiState
Hanya Baca
Tidak Direplikasi
Baca Paralel
Menentukan apakah mouse pemain ditekan secara aktif di GuiObject atau tidak.
Interactable:boolean
Baca Paralel
Menentukan apakah GuiButton dapat berinteraksi atau tidak, atau apakah GuiState dari GuiObject berubah atau tidak.
LayoutOrder:number
Baca Paralel
Mengontrol urutan sortir dari GuiObject ketika digunakan dengan UIGridStyleLayout .
NextSelectionDown:GuiObject
Baca Paralel
Tetapkan GuiObject yang akan dipilih saat pemilih gamepad dipindahkan ke bawah.
NextSelectionLeft:GuiObject
Baca Paralel
Tetapkan GuiObject yang akan dipilih saat pemilih gamepad dipindahkan ke kiri.
NextSelectionRight:GuiObject
Baca Paralel
Tetapkan GuiObject yang akan dipilih saat pemilih gamepad dipindahkan ke kanan.
NextSelectionUp:GuiObject
Baca Paralel
Tetapkan GuiObject yang akan dipilih saat pemilih gamepad dipindahkan ke atas.
Position:UDim2
Baca Paralel
Menentukan posisi piksel dan skalar dari GuiObject .
Rotation:number
Baca Paralel
Menentukan jumlah derajat di mana GuiObject diputar.
Selectable:boolean
Baca Paralel
Tentukan apakah GuiObject dapat dipilih oleh gamepad.
SelectionImageObject:GuiObject
Baca Paralel
Menggantikan dekorasi seleksi default yang digunakan untuk gamepad.
SelectionOrder:number
Baca Paralel
Pesanan dari GuiObjects dipilih oleh pilihan UI gamepad.
Size:UDim2
Baca Paralel
Menentukan ukuran piksel dan skala dari GuiObject .
SizeConstraint:Enum.SizeConstraint
Baca Paralel
Mengatur sumbu yang akan didasarkan pada, relatif terhadap ukuran orang tuanya.
Transparency:number
Tersembunyi
Tidak Direplikasi
Baca Paralel
Tidak digunakan lagi
Properti campuran dari BackgroundTransparency dan TextTransparency.
Visible:boolean
Baca Paralel
Menentukan apakah GuiObject dan keturunannya akan ditampilkan.
ZIndex:number
Baca Paralel
Menentukan urutan di mana sebuah GuiObject ditampilkan relatif terhadap yang lain.

Properti diwarisi dari GuiBase2d

AbsolutePosition:Vector2
Hanya Baca
Tidak Direplikasi
Menggambarkan posisi layar aktual dari elemen GuiBase2d , dalam piksel.
AbsoluteRotation:number
Hanya Baca
Tidak Direplikasi
Menggambarkan rotasi layar aktual dari elemen GuiBase2d , dalam derajat.
AbsoluteSize:Vector2
Hanya Baca
Tidak Direplikasi
Menggambarkan ukuran layar aktual dari elemen GuiBase2d , dalam piksel.
AutoLocalize:boolean
Baca Paralel
Ketika diatur ke true , lokalisasi akan diterapkan ke GuiBase2d dan keturunannnya.
RootLocalizationTable:LocalizationTable
Baca Paralel
Referensi ke LocalizationTable untuk digunakan untuk menerapkan lokalisasi otomatis ke GuiBase2d dan keturunannnya.
SelectionBehaviorDown:Enum.SelectionBehavior
Baca Paralel
Sesuaikan perilaku pemilihan gamepad dalam arah turun.
SelectionBehaviorLeft:Enum.SelectionBehavior
Baca Paralel
Sesuaikan perilaku pemilihan gamepad di arah kiri.
SelectionBehaviorRight:Enum.SelectionBehavior
Baca Paralel
Sesuaikan perilaku pemilihan gamepad di arah yang benar.
SelectionBehaviorUp:Enum.SelectionBehavior
Baca Paralel
Sesuaikan perilaku pemilihan gamepad dalam arah atas.
SelectionGroup:boolean
Baca Paralel
Memungkinkan kustomisasi gerakan seleksi gamepad.

Lihat semua yang diwarisi dari Instance

Lihat semua yang diwarisi dari Object

Metode

Metode diwarisi dari GuiObject

TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Dengan lancar memindahkan GUI ke baru UDim2.
TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Mengubah ukuran dengan lancar ke GuiObject baru ke UDim2.
TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Dengan lancar memindahkan GUI ke ukuran dan posisi baru.

Lihat semua yang diwarisi dari Instance

Lihat semua yang diwarisi dari Object

Acara

Acara diwarisi dari GuiObject

InputBegan(input : InputObject):RBXScriptSignal
Ditembak ketika pengguna mulai berinteraksi melalui perangkat Antarmuka Manusia-Komputer (tombol mouse turun, sentuhan mulai, tombol keyboard turun, dll).
InputChanged(input : InputObject):RBXScriptSignal
Ditembak ketika pengguna mengubah cara mereka berinteraksi melalui perangkat Antarmuka Manusia-Komputer (tombol mouse turun, sentuhan mulai, tombol keyboard turun, dll).
InputEnded(input : InputObject):RBXScriptSignal
Ditembak ketika pengguna berhenti berinteraksi melalui perangkat Antarmuka Manusia-Komputer (tombol mouse turun, sentuhan mulai, tombol keyboard turun, dll).
MouseEnter(x : number,y : number):RBXScriptSignal
Melepaskan api saat pengguna memindahkan mouse ke elemen GUI.
MouseLeave(x : number,y : number):RBXScriptSignal
Melepaskan api saat pengguna memindahkan mouse mereka keluar dari elemen GUI.
MouseMoved(x : number,y : number):RBXScriptSignal
Melepaskan api setiap kali pengguna memindahkan mouse saat berada di dalam elemen GUI.
MouseWheelBackward(x : number,y : number):RBXScriptSignal
Melepaskan api saat pengguna menggulir roda mouse kembali saat mouse berada di atas elemen GUI.
MouseWheelForward(x : number,y : number):RBXScriptSignal
Melepaskan api saat pengguna menggulir roda mouse ke depan saat mouse berada di atas elemen GUI.
SelectionGained():RBXScriptSignal
Ditembak ketika GuiObject difokuskan dengan pemilih Gamepad.
SelectionLost():RBXScriptSignal
Ditembak ketika pemilih Gamepad berhenti fokus pada GuiObject.
TouchLongPress(touchPositions : Array,state : Enum.UserInputState):RBXScriptSignal
Melepaskan api saat pemain mulai, melanjutkan dan berhenti menekan tombol UI dalam waktu lama.
TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Melepaskan api saat pemain menggerakkan jari mereka di elemen UI.
TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Melepaskan api saat pemain melakukan gerakan pinch atau pull menggunakan dua jari di elemen UI.
TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Melepaskan api saat pemain melakukan gerakan rotasi menggunakan dua jari di elemen UI.
TouchSwipe(swipeDirection : Enum.SwipeDirection,numberOfTouches : number):RBXScriptSignal
Melepaskan api saat pemain melakukan gerakan geser pada elemen UI.
TouchTap(touchPositions : Array):RBXScriptSignal
Melepaskan api saat pemain melakukan gerakan geser di elemen UI.

Acara diwarisi dari GuiBase2d

SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Memicu ketika pemilihan gamepad bergerak ke, meninggalkan, atau berubah di dalam terhubung GuiBase2d atau keturunan mana pun GuiObjects .

Lihat semua yang diwarisi dari Instance

Lihat semua yang diwarisi dari Object

Properti

AbsoluteCanvasSize

Vector2

Hanya Baca

Tidak Direplikasi

Ukuran area yang dapat discroll, dalam offset.Properti ini diatur ke maksimum dari properti CanvasSize dan ukuran anak-anak jika AutomaticCanvasSize diatur ke sesuatu selain Enum.AutomaticSize.None.

AbsoluteWindowSize

Vector2

Hanya Baca

Tidak Direplikasi

Ukuran frame, dalam offset, tanpa bilah gulir.

AutomaticCanvasSize

Enum.AutomaticSize

Baca Paralel

Properti ini digunakan untuk secara otomatis menyesuaikan objek UI orang tua berdasarkan ukuran keturunannnya.Anda dapat menggunakan properti ini untuk menambahkan teks dan konten lain secara dinamis ke ScrollingFrame pada saat edit atau waktu eksekusi dan ukurannya akan disesuaikan untuk sesuai dengan konten itu.

Ketika properti ini diatur ke nilai Enum.AutomaticSize lain selain None , AbsoluteCanvasSize mungkin diubah tergantung pada konten anaknya.

BottomImage

ContentId

Baca Paralel

Gambar yang ditampilkan di bagian bawah bilah gulir vertikal, atau di sebelah kanan bilah gulir horizontal (berputar 90° ke kanan untuk bilah gulir horizontal).

Diagram showing the three image asset elements which construct a scrolling frame's scroll bar.

CanvasPosition

Vector2

Baca Paralel

Mencerminkan offset posisi saat ini dari kanvas dalam bingkai, dalam piksel, dan mengatur posisi bilah gulir sesuai dengan itu.Perhatikan bahwa properti ini tidak melakukan apa pun jika bilah gulir tidak terlihat.

CanvasSize

UDim2

Baca Paralel

Menentukan ukuran area yang dapat discroll.Untuk alternatif adaptif berdasarkan ukuran keseluruhan anak dalam ScrollingFrame , pertimbangkan untuk menggunakan AutomaticCanvasSize .

ElasticBehavior

Enum.ElasticBehavior

Baca Paralel

Properti ini menentukan apakah dan kapan geser elastik diizinkan pada perangkat yang diaktifkan sentuhan. Nilai default adalah WhenScrollable .

HorizontalScrollBarInset

Enum.ScrollBarInset

Baca Paralel

Menunjukkan apakah CanvasSize adalah dimasukkan oleh ScrollBarThickness di sumbu horizontal.

MidImage

ContentId

Baca Paralel

Gambar yang meluas di antara TopImage dan BottomImage (berputar 90° searah kanan untuk bilah gulir horizontal).Gambar ini secara otomatis diubah untuk mengisi ruang di antara segmen tutup.

ScrollBarImageColor3

Color3

Baca Paralel

Menentukan bagaimana gambar bilah gulir ( TopImage , MidImage , BottomImage ) diwarnai.Ketika diatur ke putih, tidak ada kolorisasi terjadi.Properti ini berguna untuk menggunakan kembali aset gambar; jika gambar sumber benar-benar putih dengan transparansi, Anda dapat menetapkan warna seluruh bilah gulir sekaligus.

ScrollBarImageTransparency

number

Baca Paralel

Menentukan opasitas gambar bilah gulir ( TopImage , MidImage , BottomImage ).Nilai 0 adalah benar-benar opak dan nilai 1 adalah benar-benar transparan (tidak terlihat).

ScrollBarThickness

number

Baca Paralel

Ketebalan bilah gulir dalam piksel; berlaku untuk bilah gulir horizontal dan vertikal. Jika diatur ke 0, tidak ada bilah gulir yang ditampilkan.

ScrollingDirection

Enum.ScrollingDirection

Baca Paralel

Properti ini menentukan arah (atau) di mana gulir diizinkan.Jika gulir tidak diizinkan dalam satu arah, bilah gulir yang terkait tidak akan muncul.Default ke Enum.ScrollingDirection.XY.

ScrollingEnabled

boolean

Baca Paralel

Menentukan apakah gulir diizinkan di frame. Jika false, tidak ada bilah gulir yang akan ditampilkan.

TopImage

ContentId

Baca Paralel

Gambar yang ditampilkan di bagian atas bilah gulir vertikal, atau di sebelah kiri bilah gulir horizontal (berputar 90° ke kanan untuk bilah gulir horizontal).