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.

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.

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

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

Properti diwarisi dari LayerCollectorProperti diwarisi dari GuiBase2d

Acara

Acara diwarisi dari GuiBase2d

Properti

ClipToDeviceSafeArea

Baca Paralel

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.

Mobile device showing UI button clipped by device safe
area

Jika properti ini adalah false , GuiObject keturunan akan tidak dipotong ke area aman perangkat dan mungkin ditutupi oleh notch kamera atau potongan layar lainnya.

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

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

Baca Paralel

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

Tidak Direplikasi
Baca Paralel

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

Baca Paralel

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

Baca Paralel

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.

Mobile device showing UI buttons inside core UI safe area

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.

Metode

Acara