ScreenGui
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
ScreenGui adalah wadah penyimpanan untuk 2D GuiObjects ditampilkan di layar pengguna.Sebuah ScreenGui hanya menunjukkan jika diberi kepada pemain PlayerGui ; membesarkan seorang ScreenGui ke StarterGui memastikan bahwa ia diklon ke setiap pemain PlayerGui ketika mereka bergabung dengan pengalaman dan karakter mereka pertama kali muncul.Lihat Wadah UI di Layar untuk Detail Lebih Lanjut untuk rincian lebih lanjut.

Untuk peningkatan kinerja, penampilan ScreenGui tersimpan sampai salah satu peristiwa berikut terjadi:
- Seorang keturunan ditambahkan ke atau dihapus dari itu.
- Properti dari keturunan berubah.
- Properti dari ScreenGui itu sendiri berubah.
Jika salah satu peristiwa ini terjadi, penampilan ScreenGui di frame berikutnya di renderkan ulang.
Rangkuman
Properti
Apakah untuk memotong konten dari ini ScreenGui ke area aman perangkat.
Mengontrol perintah Z-index di mana beberapa kontainer ScreenGui ditarik.
Menentukan apakah ScreenGui melampaui batas rentang elemen UI utama Roblox.
Menentukan apakah transformasi kompatibilitas UI otomatis diterapkan ke turunan "layar penuh" GuiObjects.
Mengontrol insersi area aman yang diterapkan ke konten ScreenGui .
Mengubah visibilitas ini LayerCollector .
Menentukan apakah LayerCollector mereset (menghapus sendiri dan mengkloning kembali ke karakter pemain PlayerGui ) setiap kali karakter pemain bereinkarnasi.
Mengontrol bagaimana GuiObject.ZIndex berperilaku pada semua keturunan dari ini LayerCollector .
Menggambarkan posisi layar aktual dari elemen GuiBase2d , dalam piksel.
Menggambarkan rotasi layar aktual dari elemen GuiBase2d , dalam derajat.
Menggambarkan ukuran layar aktual dari elemen GuiBase2d , dalam piksel.
Ketika diatur ke true , lokalisasi akan diterapkan ke GuiBase2d dan keturunannnya.
Referensi ke LocalizationTable untuk digunakan untuk menerapkan lokalisasi otomatis ke GuiBase2d dan keturunannnya.
Sesuaikan perilaku pemilihan gamepad dalam arah turun.
Sesuaikan perilaku pemilihan gamepad di arah kiri.
Sesuaikan perilaku pemilihan gamepad di arah yang benar.
Sesuaikan perilaku pemilihan gamepad dalam arah atas.
Memungkinkan kustomisasi gerakan seleksi gamepad.
Acara
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 .
Properti
ClipToDeviceSafeArea
Jika properti ini adalah true , semua GuiObject keturunan dari ScreenGui akan dipotong ke area aman perangkat (lihat Enum.ScreenInsets ).Standar adalah true untuk mempertahankan kompatibilitas ke belakang UI yang disembunyikan secara sengaja di luar layar, seperti objek yang meluncur ke pandangan dari ujung layar saat diperlukan.
Jika properti ini adalah false , GuiObject keturunan akan tidak dipotong ke area aman perangkat dan mungkin ditutupi oleh notch kamera atau potongan layar lainnya.
Perhatikan bahwa properti ini akan diabaikan jika Anda mengatur ScreenInsets ke None , karena melakukan hal itu berarti Anda sengaja ingin mengabaikan insersi aman perangkat.
DisplayOrder
Properti ini mengontrol urutan Z-index di mana beberapa kontainer ScreenGui ditarik.Mereka dengan nilai lebih tinggi DisplayOrder akan ditarik di atas mereka yang memiliki nilai lebih rendah.
IgnoreGuiInset
Jika properti ini adalah false ( default ), ScreenInsets diatur ke CoreUISafeInsets , secara efektif menjaga batasnya di bawah UI inti bilah atas Roblox.
Jika properti ini diubah menjadi true dan ScreenInsets saat ini diatur ke CoreUISafeInsets , ScreenInsets akan diatur ke DeviceSafeInsets .
Lihat ScreenInsets untuk rincian tentang bagaimana inserat layar memengaruhi konten dari ScreenGui .
SafeAreaCompatibility
Properti ini menentukan apakah transformasi kompatibilitas UI otomatis diterapkan ke turunan "layar penuh" GuiObjects dari ScreenGui pada tampilan dengan pemotongan layar.Kelayakan terjadi jika total area dari keturunan GuiObject (termasuk setiap perbatasan yang diterapkan atau UIStroke ) mencakup area aman perangkat secara horizontal dan vertikal.Lihat referensi enum Enum.SafeAreaCompatibility untuk rincian.
Nilai default adalah FullscreenExtension untuk secara otomatis meningkatkan penampilan UI yang ditulis untuk layar tanpa potongan apa pun.Namun, disarankan agar Anda menghindari ekstensi layar penuh untuk pekerjaan baru; sebagai gantinya, gunakan properti ScreenInsets untuk menentukan inset mana yang harus dihormati untuk berbagai wadah ScreenGui .
Perhatikan bahwa objek UI keturunan akan terus dipotong oleh area aman perangkat jika ClipToDeviceSafeArea diatur ke true .
ScreenInsets
Properti ini mengontrol insersi area aman yang diterapkan pada konten ScreenGui .
Pengaturan default dari CoreUISafeInsets menyimpan semua keturunan GuiObjects di dalam area aman UI inti, bersih dari tombol bilah atas Roblox dan potongan layar lain seperti notch kamera perangkat.

Jika Anda mengatur properti ini ke None, objek UI mungkin tertutup di balik objek UI inti atau pemotong perangkat seperti notch kamera.Sebagai hasilnya, Anda hanya harus menggunakan None untuk ScreenGui yang berisi konten noninteraktif seperti gambar latar belakang.
Lihat Wadah UI di Layar untuk Contoh Alternatif untuk contoh alternatif.