ScreenGui

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.

Objek penyimpanan utama untuk 2D GuiObjects yang ditunjukkan di layar pengguna. Sebuah ScreenGui hanya

Example ScreenGui with various GuiObject children, including a Frame, TextLabel, TextBox, and ImageButton.

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

Properti diwarisi dari LayerCollectorProperti diwarisi dari GuiBase2d

Acara

Acara diwarisi dari GuiBase2d

Properti

ClipToDeviceSafeArea

Baca Paralel

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

Mobile device showing UI button clipped by device safe
area

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.

Mobile device showing UI button overflowing device safe
area, obscured by screen camera notch

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

Baca Paralel

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

Tidak Direplikasi
Baca Paralel

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

Baca Paralel

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

Baca Paralel

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.

Mobile device showing UI buttons inside core UI safe area

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.

Metode

Acara