ScreenGui
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
Objek penyimpanan utama untuk 2D GuiObjects yang ditunjukkan di layar pengguna. Sebuah ScreenGui hanya
Untuk peningkatan kinerja, tampilan Class.ScreenGui ScreenGui sampai salah satu dari berikut peristiwa terjadi:
- Seorang turunan ditambahkan atau dihapus dari itu.
- Properti dari leluhur berubah.
- Properti dari ScreenGui sendiri berubah.
Jika salah satu dari acara ini terjadi, tampilan ScreenGui dihitung ulang di frame berikutnya yang dihasilkan.
Rangkuman
Properti
Apakah akan menyalin konten ini ScreenGui ke area aman perangkat.
Mengontrol urutan Z-index di mana beberapa ScreenGuis ditarik.
Menentukan apakah ini ScreenGui mengalir ke dalam rentang elemen UI utama Roblox.
Meng指定 whether automatic UI kompatibilitas transformasi diterapkan untuk descendant "layar penuh" GuiObjects pada显示器上有屏幕 cutouts.
Mengontrol area yang aman yang diterapkan pada konten ini ScreenGui .
Mengubah kesichtasan dari item ini LayerCollector .
Menentukan apakah LayerCollector resets (menghapus diri dan mengklon kembali ke karakter pemain) setiap kali karakter pemain respawns.
Mengontrol cara GuiObject.ZIndex berperilaku terhadap semua cucu dari LayerCollector ini.
Menggambarkan posisi layar sebenarnya dari elemen UI, dalam pixel.
Menggambarkan rotasi layar sebenarnya dari elemen UI, dalam derajat.
Menggambarkan ukuran layar sebenarnya dari elemen UI, dalam pixel.
Ketika diatur ke benar, lokalisasi akan diterapkan ke GuiBase2d dan pendahulunya.
Sebuah referensi ke Class.LocalizationTable untuk digunakan untuk menerapkan lokalisasi otomatis ke GuiBase2d dan pendahulunya.
Mengubah perilaku pemilihan gamepad ke arah bawah.
Mengubah perilaku pemilihan gamepad di arah kiri.
Mengubah perilaku pemilihan gamepad ke arah yang benar.
Mengubah perilaku pemilihan gamepad ke arah atas.
Memungkinkan kustomisasi gerakan pemilihan gamepad.
Acara
Acara diwarisi dari GuiBase2d- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Dibakar saat pemilihan gamepad bergerak ke, pergi, atau berganti di dalam GuiBase2d atau GuiObjek Descendant apa pun.
Properti
ClipToDeviceSafeArea
Jika properti ini adalah true , semua cucu GuiObject dari cucu ini ScreenGui akan dipotong ke area aman perangkat (lihat 1> Enum.ScreenInsets1> ) . Defaultnya adalah 4> true4> unt
Jika property ini adalah false , GuiObject cucu akan tidak diotay ke area keaman perangkat dan mungkin diblokir oleh lubang kamera atau cutout lainnya dari layar.
Catat bahwa property ini akan diabaikan jika Anda menetapkan ScreenGui.ScreenInsets ke None, karena melakukannya menyiratkan bahwa Anda berniat untuk menyimpannya dengan sengaja dari setelan keselamatan perangkat.
DisplayOrder
Elemen ini mengontrol urutan Z-index di mana beberapa ScreenGuis ditunjuk. ScreenGuis dengan nilai yang lebih tinggi akan diunduh di atas mereka yang memiliki nilai yang lebih rendah.
IgnoreGuiInset
Jika property ini adalah false (默认), ScreenInsets di set ke CoreUISafeInsets secara efektif menjaga batasnya di bawah UI Roblox top bar.
Jika property ini diubah menjadi true dan ScreenInsets saat ini di set ke CoreUISafeInsets , 1> Class.ScreenGui.ScreenInsets|ScreenInsets1> akan di set ke 4> Class.ScreenGui.ScreenInsets
Lihat ScreenInsets untuk detail tentang bagaimana pengaturan layar menyangkut konten dari ScreenGui .
SafeAreaCompatibility
Item ini menggambarkan apakah transformasi kompatibilitas UI otomatis diterapkan ke "layar penuh" keturunan GuiObjects dari ScreenGui dengan potongan keselamatan. Kes
Nilai default adalah FullscreenExtension untuk meningkatkan tampilan UI yang ditulis untuk layar tanpa ada potongan. Namun, disarankan agar Anda menghindari ekstensi layar penuh untuk pekerjaan baru; sebaliknya, gunakan property ScreenInsets
Catat bahwa objek UI turunan akan terus dipotong oleh area aman perangkat jika ClipToDeviceSafeArea di set ke true .
ScreenInsets
Properti ini mengontrol area aman yang diterapkan ke konten ini ScreenGui.
Standar dari CoreUISafeInsets menyimpan semua cucu GuiObjects di dalam area UI utama, bersih dari tombol papan atas Roblox dan cutout layar lain seperti lubang kamera perangkat.
Jika Anda menetapkan property ini ke None , objek UI mungkin diblokir di belakang objek UI inti atau pemotongan perangkat seperti notch kamera. Sebagai hasilnya, Anda hanya boleh menggunakan None yang berisi konten noninteraktif seperti gambar latar belakang.
Lihat Container UI On-Screen untuk contoh alternatif.