`Class.ScreenGui` adalah wadah penyimpanan untuk 2D `Class.GuiObject|GuiObjects` ditampilkan di layar pengguna.Sebuah `Class.ScreenGui` hanya menunjukkan jika diberi kepada pemain `Class.PlayerGui` ; membesarkan seorang `Class.ScreenGui` ke `Class.StarterGui` memastikan bahwa ia diklon ke setiap pemain `Class.PlayerGui` ketika mereka bergabung dengan pengalaman dan karakter mereka pertama kali muncul.Lihat [Wadah UI di Layar untuk Detail Lebih Lanjut](/ui/on-screen-containers) untuk rincian lebih lanjut.

  <img src="../../../assets/ui/ui-objects/ScreenGui-Example.jpg" width="840" alt="Example ScreenGui with various GuiObject children, including a Frame, TextLabel, TextBox, and ImageButton." />

  Untuk peningkatan kinerja, penampilan `Class.ScreenGui` tersimpan sampai salah satu peristiwa berikut terjadi:

  *   Seorang keturunan ditambahkan ke atau dihapus dari itu.
  *   Properti dari keturunan berubah.
  *   Properti dari `Class.ScreenGui` itu sendiri berubah.

  Jika salah satu peristiwa ini terjadi, penampilan `Class.ScreenGui` di frame berikutnya di renderkan ulang.

ScreenGui

Jika properti ini adalah `true` , semua `Class.GuiObject` keturunan dari `Class.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.

  <img
    src="../../../assets/engine-api/classes/ScreenGui/ClipToDeviceSafeArea-True.png"
    width="840"
    alt="Mobile device showing UI button clipped by device safe
area"
  />

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

  <img
    src="../../../assets/engine-api/classes/ScreenGui/ClipToDeviceSafeArea-False.png"
    width="840"
    alt="Mobile device showing UI button overflowing device safe
area, obscured by screen camera notch"
  />

  Perhatikan bahwa properti ini akan diabaikan jika Anda mengatur `Class.ScreenGui.ScreenInsets|ScreenInsets` ke `Enum.ScreenInsets|None` , karena melakukan hal itu berarti Anda sengaja ingin mengabaikan insersi aman perangkat.

ScreenGui.ClipToDeviceSafeArea

Apakah untuk memotong konten dari ini `Class.ScreenGui` ke area aman perangkat.

Properti ini mengontrol urutan Z-index di mana beberapa kontainer `Class.ScreenGui` ditarik.Mereka dengan nilai lebih tinggi `Class.ScreenGui.DisplayOrder|DisplayOrder` akan ditarik di atas mereka yang memiliki nilai lebih rendah.

ScreenGui.DisplayOrder

Mengontrol perintah Z-index di mana beberapa kontainer `Class.ScreenGui` ditarik.

Jika properti ini adalah `false` ( default ), `Class.ScreenGui.ScreenInsets|ScreenInsets` diatur ke `Enum.ScreenInsets|CoreUISafeInsets` , secara efektif menjaga batasnya di bawah UI inti bilah atas Roblox.

  Jika properti ini diubah menjadi `true` dan `Class.ScreenGui.ScreenInsets|ScreenInsets` saat ini diatur ke `Enum.ScreenInsets|CoreUISafeInsets` , `Class.ScreenGui.ScreenInsets|ScreenInsets` akan diatur ke `Enum.ScreenInsets|DeviceSafeInsets` .

  Lihat `Class.ScreenGui.ScreenInsets|ScreenInsets` untuk rincian tentang bagaimana inserat layar memengaruhi konten dari `Class.ScreenGui` .

ScreenGui.IgnoreGuiInset

Menentukan apakah `Class.ScreenGui` melampaui batas rentang elemen UI utama Roblox.

Properti ini menentukan apakah transformasi kompatibilitas UI otomatis diterapkan ke turunan "layar penuh" `Class.GuiObject|GuiObjects` dari `Class.ScreenGui` pada tampilan dengan pemotongan layar.Kelayakan terjadi jika total area dari keturunan `Class.GuiObject` (termasuk setiap perbatasan yang diterapkan atau `Class.UIStroke` ) mencakup area aman perangkat secara horizontal dan vertikal.Lihat referensi enum `Enum.SafeAreaCompatibility` untuk rincian.

  Nilai default adalah `Enum.SafeAreaCompatibility|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 `Class.ScreenGui.ScreenInsets|ScreenInsets` untuk menentukan inset mana yang harus dihormati untuk berbagai wadah `Class.ScreenGui` .

  Perhatikan bahwa objek UI keturunan akan terus dipotong oleh area aman perangkat jika `Class.ScreenGui.ClipToDeviceSafeArea|ClipToDeviceSafeArea` diatur ke `true` .

ScreenGui.SafeAreaCompatibility

Menentukan apakah transformasi kompatibilitas UI otomatis diterapkan ke turunan "layar penuh" `Class.GuiObject|GuiObjects`.

Properti ini mengontrol insersi area aman yang diterapkan pada konten `Class.ScreenGui` .

  Pengaturan default dari `Enum.ScreenInsets|CoreUISafeInsets` menyimpan semua keturunan `Class.GuiObject|GuiObjects` di dalam area aman UI inti, bersih dari tombol bilah atas Roblox dan potongan layar lain seperti notch kamera perangkat.

  <img src="../../../assets/engine-api/enums/ScreenInsets/CoreUISafeInsets.png" width="840" alt="Mobile device showing UI buttons inside core UI safe area" />

  Jika Anda mengatur properti ini ke `Enum.ScreenInsets|None`, objek UI mungkin tertutup di balik objek UI inti atau pemotong perangkat seperti notch kamera.Sebagai hasilnya, Anda hanya harus menggunakan `Enum.ScreenInsets|None` untuk `Class.ScreenGui` yang berisi konten noninteraktif seperti gambar latar belakang.

  Lihat [Wadah UI di Layar untuk Contoh Alternatif](/ui/on-screen-containers#screen-insets) untuk contoh alternatif.

ScreenGui.ScreenInsets

Mengontrol insersi area aman yang diterapkan ke konten `Class.ScreenGui` .

Wadah utama elemen antarmuka pengguna 2D di layar utama.

**Pengumpul Layer** adalah kelas dasar dari kontainer UI 2D yang menampilkan turunan `Class.GuiObject` seperti `Class.ScreenGui`.

  Untuk peningkatan kinerja, penampilan `Class.LayerCollector` tersimpan sampai salah satu peristiwa berikut terjadi:

  *   Seorang keturunan ditambahkan ke atau dihapus dari itu.
  *   Properti dari keturunan berubah.
  *   Properti dari `Class.LayerCollector` itu sendiri berubah.

LayerCollector:GetLayoutNodeTree

LayerCollector

Mengubah visibilitas ini `Class.LayerCollector` . Saat `false` , konten UI tidak akan ditampilkan, memproses input pengguna, atau diperbarui untuk menanggapi perubahan.

LayerCollector.Enabled

Mengubah visibilitas ini `Class.LayerCollector` .

Ketika diatur ke `false` dan ini `Class.LayerCollector` adalah anak langsung dari `Class.StarterGui` , itu hanya akan diklon ke setiap pemain `Class.PlayerGui` sekali dan tidak akan dihapus saat karakter pemain bereinkarnasi.

  Ketika diatur ke `true` ( default ), atau jika ini `Class.LayerCollector` adalah keturunan **langsung** dari `Class.StarterGui` , itu akan diklon ke setiap pemain `Class.PlayerGui` ketika karakter mereka respawn, dan akan menghapus dirinya sendiri ketika karakter pemain respawn lagi.

LayerCollector.ResetOnSpawn

Menentukan apakah `Class.LayerCollector` mereset (menghapus sendiri dan mengkloning kembali ke karakter pemain `Class.PlayerGui` ) setiap kali karakter pemain bereinkarnasi.

Mengontrol bagaimana `Class.GuiObject.ZIndex` berperilaku pada semua keturunan dari ini `Class.LayerCollector` .

  Dengan `Enum.ZIndexBehavior.Sibling` (默认), anak-anak selalu menampilkan di atas orang tua mereka, dan `Class.GuiObject.ZIndex|ZIndex` digunakan untuk memutuskan urutan di mana anak-anak dari objek UI tunggal akan ditampilkan satu sama lain.

  `Enum.ZIndexBehavior.Global` mengurutkan semua keturunan sesuai dengan `Class.GuiObject.ZIndex|ZIndex` , kemudian memutus ikatan menggunakan urutan hierarki.Sebagai hasilnya, keturunan dari `Class.GuiObject` perlu memiliki nilai `Class.GuiObject.ZIndex|ZIndex` yang setidaknya sama tingginya dengan orang tua, atau mereka akan menampilkan di bawah orang tua mereka.

LayerCollector.ZIndexBehavior

Mengontrol bagaimana `Class.GuiObject.ZIndex` berperilaku pada semua keturunan dari ini `Class.LayerCollector` .

Kelas dasar dari kontainer UI 2D yang menyajikan `Class.GuiObject|GuiObjects` dalam lapisan.

`Class.GuiBase2d` adalah kelas abstrak yang diwarisi oleh 2D `Class.GuiObject|GuiObjects` .

Peristiwa ini terjadi ketika pemilihan gamepad bergerak ke, meninggalkan, atau berubah dalam `Class.GuiBase2d` atau keturunan mana pun `Class.GuiObject|GuiObjects` .Ketika sorotan pemilihan bergerak ke `Class.GuiObject` , gelembung peristiwa dari `Class.GuiObject` ke semua leluhur, memberi tahu mereka bahwa pilihan telah berubah/masuk/keluar ke `Class.GuiObject` di pohon keturunan mereka.

GuiBase2d.SelectionChanged

amISelected

Benar jika pilihan baru cocok dengan GuiBase2d yang dilampirkan.

previousSelection

newSelection

Memicu ketika pemilihan gamepad bergerak ke, meninggalkan, atau berubah di dalam terhubung `Class.GuiBase2d` atau keturunan mana pun `Class.GuiObject|GuiObjects` .

GuiBase2d

`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` adalah properti hanya baca yang memberikan posisi layar elemen `Class.GuiBase2d` dalam piksel.Ini mewakili posisi piksel yang sebenarnya di mana elemen ditampilkan sebagai hasil dari ukuran dan posisi leluhur.Perhatikan bahwa `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` selalu mewakili sudut kiri atas dari elemen `Class.GuiBase2d`.

  Jika `Class.GuiBase2d` berada di dalam `Class.ScreenGui`, properti `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` menggunakan sistem koordinat jendela pandang `Enum.ScreenInsets|CoreUISafeInsets`.Asal sistem koordinat ini terletak di sudut kiri bawah bilah atas Roblox.Perhatikan bahwa ini adalah sistem koordinat yang sama yang digunakan oleh properti `Class.InputObject.Position`.

  <img src="/assets/engine-api/classes/GuiBase2d/AbsolutePositionCoordinateSystem.png" width="840" alt="Diagram showing the origin of the AbsolutePosition coordinate system." />

  Lihat juga `Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` dan `Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.

GuiBase2d.AbsolutePosition

Menggambarkan posisi layar aktual dari elemen `Class.GuiBase2d` , dalam piksel.

`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` adalah properti baca hanya yang menggambarkan rotasi layar aktual dari elemen `Class.GuiBase2d`, dalam derajat.Ini tidak **tidak** melakukan pemeriksaan batas, jadi nilainya mungkin tidak berada dalam rentang `0` ke `360`.

  Lihat juga `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` dan `Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.

GuiBase2d.AbsoluteRotation

Menggambarkan rotasi layar aktual dari elemen `Class.GuiBase2d` , dalam derajat.

`Class.GuiBase2d.AbsoluteSize|AbsoluteSize` adalah properti baca hanya yang menggambarkan ukuran layar aktual dari elemen `Class.GuiBase2d`, dalam piksel.

  Lihat juga `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` dan `Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation`.

GuiBase2d.AbsoluteSize

Menggambarkan ukuran layar aktual dari elemen `Class.GuiBase2d` , dalam piksel.

Ketika diatur ke `true` , lokalisasi akan diterapkan ke `Class.GuiBase2d` dan keturunannnya.Entri yang digunakan untuk lokalisasi adalah set entri yang sama yang dikembalikan oleh `Class.LocalizationService:GetTableEntries()` .Entri dengan `Class.GuiBase2d.AutoLocalize|AutoLocalize` diaktifkan secara otomatis diterjemahkan ulang setelah tabel cloud dimuat jika diperlukan.

  Lihat juga `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable` .

GuiBase2d.AutoLocalize

Ketika diatur ke `true` , lokalisasi akan diterapkan ke `Class.GuiBase2d` dan keturunannnya.

Properti ini secara otomatis diatur ke benar saat tabel lokalisasi menargetkan objek ini, atau leluhur dari objek ini. `Class.LocalizationTable|LocalizationTables` dengan properti `Class.LocalizationTable.Root` mereka yang ditunjuk ke instans akan melokalkan semua `Class.TextLabel.TextButton` yang merupakan keturunan dari kejadianakar.

GuiBase2d.Localize

Secara otomatis atur ke benar ketika tabel lokalisasi menargetkan objek ini, atau leluhur dari objek ini.

Referensi ke `Class.LocalizationTable` untuk digunakan untuk menerapkan lokalisasi otomatis ke `Class.GuiBase2d` dan keturunannnya. `Class.GuiBase2d.AutoLocalize|AutoLocalize` harus diatur ke `true` pada `Class.GuiBase2d` dan leluhurnya agar lokalisasi otomatis diterapkan.

  Anda dapat mengatur ini untuk merujuk pada `Class.LocalizationTable` di mana saja di `Class.DataModel`.Objek `Class.GuiBase2d` dan semua anaknya akan mencoba menggunakan spesifik `Class.LocalizationTable` dan nenek moyangnya untuk penggantian teks otomatis sebelum menggunakan tabel di bawah `Class.LocalizationService` dalam urutan yang tidak didefinisikan dan tabel cloud.

  Jika tidak ada terjemahan yang tersedia di tabel referensi, itu akan mencari terjemahan di orang tuanya, jika itu juga `Class.LocalizationTable` , dan seterusnya.

  Lihat juga `Class.LocalizationService:GetTableEntries()` yang menjelaskan bagaimana `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable` digunakan untuk Pelokalanotomatis.

GuiBase2d.RootLocalizationTable

Referensi ke `Class.LocalizationTable` untuk digunakan untuk menerapkan lokalisasi otomatis ke `Class.GuiBase2d` dan keturunannnya.

Sesuaikan perilaku pemilihan gamepad dalam arah turun.

GuiBase2d.SelectionBehaviorDown

Sesuaikan perilaku pemilihan gamepad di arah kiri.

GuiBase2d.SelectionBehaviorLeft

Sesuaikan perilaku pemilihan gamepad di arah yang benar.

GuiBase2d.SelectionBehaviorRight

Sesuaikan perilaku pemilihan gamepad dalam arah atas.

GuiBase2d.SelectionBehaviorUp

Memungkinkan untuk kustomisasi bagaimana pemilihan gamepad dapat bergerak di antara tombol, yang merupakan keturunan dari gruppemilihan, meninggalkan grup, dan memilih tombol lain.

  Mengatur `Class.GuiBase2d.SelectionGroup|SelectionGroup` ke `true` mengekspos `Class.GuiBase2d.SelectionBehaviorUp|SelectionBehaviorUp` , `Class.GuiBase2d.SelectionBehaviorDown|SelectionBehaviorDown` , `Class.GuiBase2d.SelectionBehaviorLeft|SelectionBehaviorLeft` , dan `Class.GuiBase2d.SelectionBehaviorRight|SelectionBehaviorRight` properti.Untuk perilaku seleksi ini, pengaturan `Enum.SelectionBehavior.Escape` ( default ) berarti bahwa pemilihan gamepad mencoba untuk pertama kali menemukan seleksi di dalam kelompok seleksi dan hanya bergerak di luar jika tidak menemukan tombol yang sesuai.Alternatifnya, pengaturan `Enum.SelectionBehavior.Stop` berarti pemilihan gamepad hanya terlihat dalam kelompok pemilihan dan tidak bergerak di luar kelompok dari arah perilaku pemilihan.

GuiBase2d.SelectionGroup

Memungkinkan kustomisasi gerakan seleksi gamepad.

Kelas abstrak yang mewarisi oleh 2D `Class.GuiObject|GuiObjects` .

GuiBase adalah kelas abstrak yang sebagian besar objek antarmuka pengguna grafis mewarisi dari.

GuiBase

`Instance` adalah kelas dasar untuk semua kelas dalam hierarki kelas Roblox yang dapat menjadi bagian dari pohon `Class.DataModel`.

  Tidak mungkin untuk langsung membuat objek akar `Instance` , tetapi konstruktor khusus `Datatype.Instance.new()` membuat objek melalui kode, mengambil nama kelas sebagai parameter dan mengembalikan objek yang dibuat.

Demonstrates detecting changes to an instance's ancestry by connecting to the `Class.Instance.AncestryChanged` event.

The ChangingPart's Parent is set to different values overtime. The parent of the part is the part's ancestor, so the `Class.Instance.AncestryChanged` event will fire whenever it changes.

Memicu ketika properti `Class.Instance.Parent` dari objek atau salah satu leluhurnya diubah.

  Acara ini mencakup dua parameter: merujuk pada yang sebenarnya telah diubah, sementara merujuk pada baru kasus ini.

  Anda dapat menggunakan acara ini untuk melacak penghapusan instansi di Studio, seperti penghapusan manual di Explorer atau melalui plugin.Jika Anda perlu mendeteksi kapan instansi dihancurkan menggunakan `Class.Instance:Destroy()` , gunakan acara `Class.Instance.Destroying` sebagai gantinya.

Instance.AncestryChanged

child

The `Class.Instance` yang `Class.Instance.Parent` telah diubah.

parent

The new `Class.Instance.Parent` dari `Class.Instance` yang `Class.Instance.Parent` telah diubah.

Memicu ketika properti `Class.Instance.Parent` dari objek atau salah satu leluhurnya diubah.

Peristiwa ini terjadi setiap kali ada atribut yang diubah pada instans, termasuk saat atribut diatur ke `nil` .Nama atribut yang diubah dikirim ke fungsi terhubung.

  Sebagai contoh, potongan kode berikut menghubungkan fungsi `attributeChanged()` ke api setiap kali salah satu atribut bagian berubah:

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part

  local function attributeChanged(attributeName)
  	print(attributeName, "changed")
  end

  part.AttributeChanged:Connect(attributeChanged)
  ```

  Lihat juga `Class.Instance:GetAttributeChangedSignal()` yang men返ikan peristiwa yang menyala saat atribut tertentu berubah.

Instance.AttributeChanged

attribute

Memicu kebakaran setiap kali atribut diubah pada `Class.Instance`.

This snippet prints the names of objects as they are added to the Workspace:

Api setelah objek diberikan kepada orangtua ini `Class.Instance` .

  Catatan, saat menggunakan fungsi ini pada klien untuk mendeteksi objek yang dibuat oleh server, diperlukan untuk menggunakan `Class.Instance:WaitForChild()` saat mengindeks keturunan objek ini.Ini karena objek dan keturunannnya tidak dijamin untuk mereplikasi dari server ke klien secara bersamaan.Sebagai contoh:

  ```
  local Workspace = game:GetService("Workspace")

  Workspace.ChildAdded:Connect(function(child)
  	-- Use WaitForChild() since descendants may not have replicated yet
  	local head = child:WaitForChild("Head")
  end)
  ```

  Catatan, fungsi ini hanya berfungsi untuk anak-anak langsung dari `Class.Instance` . Untuk fungsi yang menangkap semua keturunan, gunakan `Class.Instance.DescendantAdded` .

  Lihat juga `Class.Instance.ChildRemoved` .

Instance.ChildAdded

The `Class.Instance` yang telah ditambahkan.

Api setelah objek diberikan kepada orangtua ini `Class.Instance` .

This snippet prints the names of objects as they are removed from the
Workspace:

Api setelah anak dihapus dari ini `Class.Instance` .

  Dihapus merujuk pada ketika orangtua objek diubah dari ini `Class.Instance` ke sesuatu yang berbeda dari ini `Class.Instance` .Catatan, acara ini juga akan terjadi saat anak dihancurkan (menggunakan `Class.Instance:Destroy()` ) karena fungsi hancur menetapkan orangtua objek menjadi `nil` .

  Fungsi ini hanya berfungsi untuk anak-anak langsung dari `Class.Instance` . Untuk fungsi yang menangkap semua keturunan, gunakan `Class.Instance.DescendantRemoving` .

  Lihat juga `Class.Instance.ChildAdded` .

Instance.ChildRemoved

Api setelah anak dihapus dari ini `Class.Instance` .

This following example will print the name of any object that is added to the
Workspace:

Peristiwa ini terjadi setelah keturunan ditambahkan ke `Class.Instance`.

  Saat menembak untuk setiap keturunan, membesarkan objek ke `Class.Instance` akan menembakkan peristiwa untuk objek ini dan semua keturunannnya secara individual.

  Jika Anda hanya peduli dengan anak-anak langsung dari , gunakan sebagai gantinya.

  Lihat juga `Class.Instance.DescendantRemoving` .

Instance.DescendantAdded

descendant

Api setelah keturunan ditambahkan ke `Class.Instance` .

The following example prints the name of any descendant as it is being removed
from the Workspace:

Peristiwa ini menembak **segera sebelum** orangtua `Class.Instance` mengubah sehingga instansi **turunan** tidak lagi menjadi turunan.`Class.Instance:Destroy()|Destroy()` mengubah `Class.Instance.Parent|Parent` instansi menjadi `nil` , sehingga memanggil metode itu pada turunan dari orangtua akan menyebabkan peristiwa ini terjadi.

  Karena acara ini menembak **sebelum** penghapusan keturunan, orangtua keturunan tidak akan berubah saat penembakan acara ini.Jika keturunan juga merupakan anak langsung **dari orang tua** , acara ini akan terbakar sebelum `Class.Instance.ChildRemoved`.

  Jika seorang keturunan memiliki anak, acara ini terbakar dengan keturunan terlebih dahulu, diikuti oleh anak-anaknya.

  ##### Peringatan

  Peristiwa ini terjadi dengan objek keturunan yang dihapus.Mencoba untuk mengatur `Class.Instance.Parent|Parent` anak turun ke sesuatu yang lain akan gagal.Di bawah ini adalah contoh yang menunjukkan ini:

  ```
  local Workspace = game:GetService("Workspace")

  Workspace.DescendantRemoving:Connect(function(descendant)
  	-- Do not manipulate the parent of the descendant in this function!
  	-- This event fires BECAUSE the parent was manipulated, and the change hasn't happened yet
  	-- Therefore, it is problematic to change the parent like this:
  	descendant.Parent = game
  end)

  local part = Instance.new("Part")
  part.Parent = Workspace
  part.Parent = nil
  ```

  Lihat juga `Class.Instance.DescendantAdded|DescendantAdded` .

Instance.DescendantRemoving

Api segera sebelum keturunan dari `Class.Instance` dihapuskan.

This sample demonstrates how, when using Immediate signal behavior, an Instance being destroyed remains in place until the connected function yields.

This sample demonstrates how, when using Deferred signal behavior,
an Instance is destroyed before the signal fires.

The `Class.Instance` tidak akan pernah dihapus dari memori saat fungsi terhubung masih menggunakannya.Namun, jika fungsi menghasilkan di titik mana pun, `Class.Instance` dan keturunannnya akan diberikan kepada `nil` .

  Jika properti `Class.Workspace.SignalBehavior` diatur ke `Enum.SignalBehavior.Immediate` , acara ini terbakar segera sebelum `Class.Instance` atau salah satu leluhurnya hancur dengan `Class.Instance:Destroy()` .

  Jika properti `Class.Workspace.SignalBehavior` diatur ke `Enum.SignalBehavior.Deferred` , acara ini akan terjadi di titik penyambungan berikutnya, yang akan terjadi setelah `Class.Instance` atau salah satu leluhurnya hancur dengan `Class.Instance:Destroy()` .

  Dengan perilaku `Enum.SignalBehavior.Deferred|Deferred` , menghubungkan skrip ke acara sendiri `Class.Instance.Destroying` adalah bermasalah, karena skrip akan dihapus sebelum panggilan balasan dapat dilakukan (berarti tidak akan dieksekusi).

  Saat menghapus `Class.Instance` di Studio, seperti menghapus secara manual melalui [Explorer](/studio/explorer) atau melalui plugin, `Class.Instance` tidak hancur.Sebagai gantinya, orangtua diatur ke `nil` yang dapat Anda pelacak dengan `Class.Instance.AncestryChanged` .

Instance.Destroying

Api segera sebelum (atau ditunda sampai setelah) instansi dihancurkan melalui `Class.Instance:Destroy()` .

Acara ini terjadi setiap kali properti gaya diubah pada instance, termasuk saat properti diatur ke `nil` .

  ```lua
  local Players = game:GetService("Players")

  local player = Players.LocalPlayer
  local playerGui = player.PlayerGui
  local HUDContainer = playerGui:WaitForChild("HUDContainer")
  local meterBar = HUDContainer.MeterBar

  local function stylePropertyChanged()
  	print("Styled properties changed")
  end

  meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
  ```

Instance.StyledPropertiesChanged

Memicu kapan pun properti gaya diubah pada instans, termasuk saat properti diatur ke `nil` .

Instance.childAdded

Metode ini menerapkan tag ke instansi, tanpa efek jika tag sudah diterapkan.Berhasil menambahkan tag akan menyala sinyal yang dibuat oleh `Class.CollectionService:GetInstanceAddedSignal()` dengan tag yang diberikan.

  ##### Peringatan

  *   Tag instansi yang ditambahkan sisi klien akan dihapus jika server kemudian menambahkan atau menghapus tag pada instansi itu karena server menyalin semua tag bersama-sama dan menghapus tag sebelumnya.

  *   Saat menandai instansi, umumnya beberapa sumber daya digunakan untuk memberikan tag fungsionalnya, misalnya koneksi acara atau tabel.Untuk mencegah kebocoran memori, ide bagus adalah membersihkan ini (putus koneksi, atur ke `nil` , dll.) ketika tidak lagi dibutuhkan untuk tag.Lakukan ini saat menelepon `Class.Instance:RemoveTag()` , menelepon `Class.Instance:Destroy()` , atau dalam fungsi yang terhubung ke sinyal yang dikembalikan oleh `Class.CollectionService:GetInstanceRemovedSignal()` .

Instance:AddTag

Fungsi ini menghancurkan semua anak dan keturunan instansi.

  ```
  local part = Instance.new("Part")

  -- Add some sparkles
  for i = 1, 3 do
  	local sparkles = Instance.new("Sparkles")
  	sparkles.Parent = part

    local sc = Instance.new("Sparkles")
    sc.Parent = sparkles
  end

  print("Children:", #part:GetChildren())  --> Children: 3

  part:ClearAllChildren()

  print("Children:", #part:GetChildren())  --> Children: 0
  ```

  Jika Anda tidak ingin menghancurkan **semua** anak-anak dan keturunan, gunakan `Class.Instance:GetChildren()` atau `Class.Instance:GetDescendants()` untuk melingkar melalui anak-anak / keturunan itu dan pilih apa yang harus dihancurkan.Sebagai contoh, sampel kode berikut akan menghancurkan semua `Class.BasePart|BaseParts` turun dari sebuah `Class.Model` :

  ```
  local Workspace = game:GetService("Workspace")

  local model = Workspace:FindFirstChild("TestModel")

  for _, descendant in model:GetDescendants() do
  	if descendant:IsA("BasePart") then
  		descendant:Destroy()
  	end
  end
  ```

Instance:ClearAllChildren

Fungsi ini menghancurkan semua anak instansi.

Demonstrates cloning a model using `Class.Instance:Clone()`.

`Clone()` membuat salinan instansi dan semua keturunannnya, mengabaikan semua instansi yang tidak `Class.Instance.Archivable|Archivable` .Salinan instansi akar dikembalikan oleh metode ini dan `Class.Instance.Parent|Parent` nya diatur ke `nil` .Perhatikan bahwa jika instance itu sendiri memiliki `Class.Instance.Archivable|Archivable` diatur ke `false` , fungsi ini akan kembali `nil` .

  Jika properti referensi seperti `Class.ObjectValue.Value` ditetapkan di instansi yang diklon, nilai properti salinan tergantung pada nilai asli:

  *   Jika properti referensi merujuk pada instansi yang telah **juga** diklon, salinan akan merujuk pada salinan.
  *   Jika properti referensi merujuk ke objek yang tidak **tidak** diklon, nilai yang sama dipertahankan dalam salinan.

Instance:Clone

Buat salinan instansi dan semua keturunannya, mengabaikan instansi yang tidak `Class.Instance.Archivable|Archivable` .

Menunjukkan menghancurkan Suku Cadang menggunakan fungsi `Class.Instance:Destroy()`.

  Fungsi ini adalah cara yang benar untuk menyingkirkan objek yang tidak lagi diperlukan.

Atur properti `Class.Instance.Parent` ke `nil` , mengunci properti `Class.Instance.Parent` , memutus semua koneksi, dan memanggil `Destroy()` pada semua anak.Fungsi ini adalah cara yang benar untuk menyingkirkan objek yang tidak lagi diperlukan.

  Menyingkirkan objek yang tidak diperlukan penting, karena objek dan koneksi yang tidak perlu di tempat menggunakan memori yang dapat menyebabkan masalah kinerja serius seiring waktu.

  Sebagai praktik terbaik setelah memanggil `Destroy()` pada objek, atur variabel apa pun yang merujuk pada objek (atau keturunannnya) ke `nil` .Ini mencegah kode Anda mengakses apa pun yang berhubungan dengan objek.

  ```lua
  local part = Instance.new("Part")
  part.Name = "Hello, world"
  part:Destroy()
  -- Jangan lakukan ini:
  print(part.Name)  --> "Halo, dunia"
  -- Lakukan ini untuk mencegah baris di atas tidak berfungsi:
  part = nil
  ```

  Setelah `Class.Instance` dihancurkan dengan metode ini, tidak dapat digunakan kembali karena properti `Class.Instance.Parent` terkunci.Untuk **sementara** menghapus objek alih-alih menghancurkannya, atur `Class.Instance.Parent|Parent` ke `nil`.Sebagai contoh:

  ```
  local Workspace = game:GetService("Workspace")

  object.Parent = nil
  task.wait(2)
  object.Parent = Workspace
  ```

  Untuk menghancurkan objek setelah jumlah waktu tertentu, gunakan `Class.Debris:AddItem()` .

Instance:Destroy

Atur properti `Class.Instance.Parent` ke `nil` , mengunci properti `Class.Instance.Parent` , memutus semua koneksi, dan memanggil `Destroy()` pada semua anak.

Kembalikan nenek moyang pertama dari `Class.Instance` yang `Class.Instance.Name` sama dengan nama yang diberikan.

  Fungsi ini bekerja ke atas, artinya dimulai pada langsung instansi `Class.Instance.Parent` dan bekerja menuju `Class.DataModel` .Jika tidak ada leluhur yang cocok ditemukan, ia kembalikan `nil` .

  Potongan kode berikut akan menemukan nenek moyang pertama dari objek bernama `Car` .

  ```
  local car = object:FindFirstAncestor("Car")
  ```

  Untuk varian fungsi ini yang menemukan leluhur kelas tertentu, silakan lihat `Class.Instance:FindFirstAncestorOfClass()` dan `Class.Instance:FindFirstAncestorWhichIsA()` .

Instance:FindFirstAncestor

name

Kembalikan nenek moyang pertama dari `Class.Instance` yang `Class.Instance.Name` sama dengan nama yang diberikan.

Kembalikan nenek moyang pertama dari `Class.Instance` yang `Class.Object.ClassName` sama dengan kelas yang diberikan.

  Fungsi ini bekerja ke atas, artinya dimulai pada langsung instansi `Class.Instance.Parent` dan bekerja menuju `Class.DataModel` .Jika tidak ada leluhur yang cocok ditemukan, ia kembalikan `nil` .

  Penggunaan umum dari fungsi ini adalah menemukan `Class.Model` milik `Class.BasePart` . Misalnya:

  ```
  local model = part:FindFirstAncestorOfClass("Model")
  ```

  Fungsi ini adalah variasi dari `Class.Instance:FindFirstAncestor()` yang memeriksa properti `Class.Object.ClassName` bukan `Class.Instance.Name`.`Class.Instance:FindFirstAncestorWhichIsA()` juga ada, menggunakan metode `Class.Object:IsA()` untuk menghormati warisan kelas.

Instance:FindFirstAncestorOfClass

className

The `Class.Object.ClassName` untuk dicari.

Kembalikan nenek moyang pertama dari `Class.Instance` yang `Class.Object.ClassName` sama dengan kelas yang diberikan.

Kembalikan nenek moyang pertama dari `Class.Instance` untuk siapa `Class.Object:IsA()` kembali benar untuk kelas yang diberikan.

  Fungsi ini bekerja ke atas, artinya dimulai pada langsung instansi `Class.Instance.Parent` dan bekerja menuju `Class.DataModel` .Jika tidak ada leluhur yang cocok ditemukan, ia kembalikan `nil` .

  Tidak seperti `Class.Instance:FindFirstAncestorOfClass()` , fungsi ini menggunakan `Class.Object:IsA()` yang menghormati warisan kelas. Misalnya:

  ```
  print(part:IsA("Part"))  --> true
  print(part:IsA("BasePart"))  --> true
  print(part:IsA("Instance"))  --> true
  ```

  Oleh karena itu, sampel kode berikut akan mengembalikan nenek moyang pertama `Class.BasePart` , terlepas dari apakah itu adalah `Class.WedgePart` , `Class.MeshPart` atau `Class.Part` .

  ```
  local part = object:FindFirstAncestorWhichIsA("BasePart")
  ```

  Lihat juga `Class.Instance:FindFirstAncestor()` .

Instance:FindFirstAncestorWhichIsA

Kembalikan nenek moyang pertama dari `Class.Instance` untuk siapa `Class.Object:IsA()` kembali benar untuk kelas yang diberikan.

Yang berikut akan mencari di Workspace untuk nama objek "Brick". Jika ditemukan, itu akan mengubah nama objek menjadi "Foo".

Kembalikan anak pertama dari `Class.Instance` dengan nama yang diberikan, atau `nil` jika tidak ada anak seperti itu.Jika argumen opsional `recursive` opsional adalah `true` , fungsi ini mencari semua keturunan daripada hanya anak-anak langsung dari `Class.Instance` .

  ##### Memeriksa Keberadaan Objek

  `FindFirstChild()` diperlukan jika Anda perlu memverifikasi objek ada sebelum melanjutkan.Mencoba mengindeks anak dengan nama menggunakan operator dot memunculkan kesalahan jika anak tidak ada.

  ```lua
  local Workspace = game:GetService("Workspace")

  -- Kesalahan baris berikut jika bagian tidak ada di ruang kerja
  Workspace.Part.Transparency = 0.5
  ```

  Pendekatan yang lebih baik adalah menggunakan `FindFirstChild()` untuk memeriksa `Part` terlebih dahulu, lalu gunakan pernyataan `if` untuk menjalankan kode yang membutuhkannya.

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace:FindFirstChild("Part")
  if part then
  	part.Transparency = 0.5
  end
  ```

  ##### Menemukan Anak yang Nama Nya Sesuai dengan Properti

  Terkadang `Class.Instance.Name|Name` dari objek adalah sama dengan properti dari objeknya `Class.Instance.Parent|Parent` .Saat menggunakan operator dot, properti memiliki prioritas lebih tinggi atas anak-anak jika mereka berbagi nama.

  Dalam contoh berikut, `Class.Folder` yang disebut `Color` ditambahkan ke `Class.Part` , yang juga memiliki properti `Class.Part.Color`.Perhatikan bahwa `part.Color` merujuk pada nilai properti `Datatype.Color3` , bukan anak `Class.Folder` instansi.Manfaat menggunakan `Class.Instance:FindFirstChild()|FindFirstChild()` adalah bahwa pengenalan properti baru tidak memberikan risiko pada kode Anda.

  ```lua
  local part = Instance.new("Part")
  local folder = Instance.new("Folder")
  folder.Name = "Color"
  folder.Parent = part
  local c1 = part.Color  -- Kepemilikan
  local c2 = part:FindFirstChild("Color")  -- The child folder
  ```

  ##### Catatan Kinerja

  `Class.Instance:FindFirstChild()|FindFirstChild()` membutuhkan waktu sekitar 20% lebih lama dari menggunakan operator dot dan hampir 8 kali lebih lama dari sekadar menyimpan referensi ke objek.Oleh karena itu, Anda harus menghindari memanggilnya dalam kode bergantung pada kinerja seperti di loop ketat atau fungsi yang terhubung ke `Class.RunService.Heartbeat` dan `Class.RunService.PreRender` .Sebagai gantinya, simpan hasil dalam variabel, atau pertimbangkan untuk menggunakan `Class.Instance.ChildAdded|ChildAdded` atau `Class.Instance:WaitForChild()|WaitForChild()` untuk mendeteksi kapan anak dari nama tertentu menjadi tersedia.

Instance:FindFirstChild

The `Class.Instance.Name` yang harus dicari.

recursive

Apakah pencarian harus dilakukan secara berulang atau tidak.

Kembalikan anak pertama dari `Class.Instance` yang ditemukan dengan nama yang diberikan.

Kembalikan anak pertama dari `Class.Instance` yang `Class.Object.ClassName|ClassName` sama dengan yang diberikan `className` .Tidak seperti `Class.Instance:FindFirstChildWhichIsA()` , fungsi ini hanya mengembalikan objek yang kelasnya cocok dengan `className` , mengabaikan warisan kelas.Jika anak yang cocok tidak ditemukan, fungsi ini akan mengembalikan `nil` .

Instance:FindFirstChildOfClass

Kembalikan anak pertama dari `Class.Instance` yang `Class.Object.ClassName|ClassName` sama dengan nama kelas yang diberikan.

Kembalikan anak pertama dari `Class.Instance` untuk siapa `Class.Object:IsA()` kembali benar untuk kelas yang diberikan.

  Jika tidak ada anak yang cocok ditemukan, fungsi ini返回 `nil` .Jika argumen recursif opsional benar, fungsi ini mencari semua keturunan daripada hanya anak-anak langsung dari `Class.Instance` .

  Tidak seperti `Class.Instance:FindFirstChildOfClass()` , fungsi ini menggunakan `Class.Object:IsA()` yang menghormati warisan kelas. Misalnya:

  ```lua
  print(part:IsA("Part")) --> benar
  print(part:IsA("BasePart")) --> benar
  print(part:IsA("Instance")) --> true
  ```

  Oleh karena itu, sampel kode berikut akan mengembalikan anak pertama `Class.BasePart` , terlepas dari apakah itu adalah `Class.WedgePart` , `Class.MeshPart` atau `Class.Part` .

  ```
  local part = object:FindFirstChildWhichIsA("BasePart")
  ```

  Pengembang yang mencari anak dengan nama, harus menggunakan `Class.Instance:FindFirstChild()` sebagai gantinya.

Instance:FindFirstChildWhichIsA

The `Class.Object.ClassName` yang harus dicari.

Kembalikan anak pertama dari `Class.Instance` untuk siapa `Class.Object:IsA()` kembali benar untuk kelas yang diberikan.

Kembalikan keturunan pertama yang ditemukan dengan `Class.Instance.Name` yang diberikan.

  Metode ini dinonaktifkan dan tidak dapat digunakan.Untuk menemukan keturunan pertama dari instansi, pertimbangkan menggunakan parameter `recursive` pada `Class.Instance:FindFirstChild()` sebagai gantinya.

Instance:FindFirstDescendant

Kembalikan keturunan pertama yang ditemukan dengan `Class.Instance.Name` yang diberikan.

Jika `Class.Instance` adalah `Class.Actor` , maka `Class.Actor` sendiri dikembalikan.Jika tidak, leluhur terdekatnya `Class.Actor` dikembalikan.Jika tidak ada leluhur adalah `Class.Actor` , hasilnya adalah `nil` .

Instance:GetActor

Kembalikan `Class.Actor` yang terkait dengan Instansi, jika ada.

Metode ini mengembalikan nilai yang telah ditugaskan ke nama atribut yang diberikan. Jika tidak ada atribut yang ditugaskan, `nil` dikembalikan.

  Sebagai contoh, potongan kode berikut menetapkan dan kemudian mendapatkan nilai atribut instance `InitialPosition`:

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part
  part:SetAttribute("InitialPosition", part.Position)

  local initialPosition = instance:GetAttribute("InitialPosition")
  print(initialPosition)
  ```

  ##### Lihat Juga

  *   `Class.Instance:SetAttribute()` yang mengatur atribut dengan nama yang diberikan ke nilai yang diberikan.
  *   `Class.Instance:GetAttributes()` yang men返ikan kamus pasangan kunci-nilai untuk setiap atribut instansi.

Instance:GetAttribute

Nilai yang telah ditugaskan ke nama atribut yang diberikan. Jika tidak ada atribut yang ditugaskan, `nil` dikembalikan.

Kembalikan nilai yang telah ditugaskan ke nama atribut yang diberikan.

Fungsi ini mengembalikan peristiwa yang berperilaku persis seperti peristiwa `Class.Object.Changed|Changed` , kecuali bahwa itu hanya menembak ketika atribut tertentu berubah; secara efektif itu mirip dengan `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` tetapi untuk atribut.

  Secara umum, ide yang baik adalah menggunakan metode ini alih-alih koneksi ke `Class.Object.Changed|Changed` dengan fungsi yang memeriksa nama atribut.Panggilan berikutnya ke metode ini pada objek yang sama dengan nama atribut yang sama mengembalikan peristiwa yang sama.

  Contoh kode berikut mengembalikan sinyal yang memicu fungsi `attributeChanged()` ketika atribut bagian `InitialPosition` berubah:

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part
  part:SetAttribute("InitialPosition", part.Position)

  local function attributeChanged()
  	print("Attribute changed")
  end

  part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
  ```

  Lihat juga `Class.Instance.AttributeChanged` yang menembak setiap kali ada atribut yang diubah pada instans.

Instance:GetAttributeChangedSignal

Nama atribut yang ditentukan untuk mana sinyal perubahan dikembalikan.

Sebuah peristiwa yang menembak ketika atribut yang diberikan berubah.

Kembalikan acara yang terbakar saat atribut yang diberikan berubah.

Metode ini mengembalikan kamus pasangan kunci-nilai untuk setiap atribut di mana kunci adalah nama atribut dan nilainya adalah nilai non-`nil` .

  Sebagai contoh, potongan kode berikut menampilkan atribut dan nilai instansi:

  ```lua
  local Workspace = game:GetService("Workspace")

  local part = Workspace.Part
  part:SetAttribute("InitialPosition", part.Position)
  part:SetAttribute("CanUse", true)

  for name, value in part:GetAttributes() do
  	print(name .. " = " .. value)
  end
  ```

  Lihat juga `Class.Instance:GetAttribute()` yang men返ikan nilai yang telah ditugaskan ke nama atribut yang diberikan.

Instance:GetAttributes

Kamus pasangan string → varian untuk setiap atribut di mana string adalah nama atribut dan varian adalah nilai non-nol.

The below would print the name of all objects currently in Workspace when ran.

Kembalikan array (tabel berindeks numerik) yang berisi semua anak langsung instansi, atau setiap `Class.Instance` yang `Class.Instance.Parent|Parent` sama dengan objek.배열 dapat diulang saat menggunakan loop for numerik atau umum:

  ```lua
  local Workspace = game:GetService("Workspace")

  -- Contoh lop loop numerik
  local children = Workspace:GetChildren()
  for i = 1, #children do
  	local child = children[i]
  	print(child.Name .. " is child number " .. i)
  end
  ```

  ```lua
  local Workspace = game:GetService("Workspace")

  -- Contoh lop loop umum
  local children = Workspace:GetChildren()
  for i, child in children do
  	print(child.Name .. " is child number " .. i)
  end
  ```

  Anak-anak diurutkan berdasarkan urutan di mana properti `Class.Instance.Parent|Parent` mereka ditetapkan ke objek.

  Lihat juga fungsi `Class.Instance:GetDescendants()|GetDescendants`.

Instance:GetChildren

Sebuah array yang berisi anak-anak instansi.

Kembalikan array yang berisi semua anak instansi.

Kembalikan string terkode dari ID debug yang digunakan secara internal oleh Roblox. Perhatikan bahwa:

  *   Item ini dilindungi. Mencoba menggunakannya di `Class.Script` atau `Class.LocalScript` akan menyebabkan kesalahan.
  *   ID debug adalah ID yang digunakan dalam proses debugging.Ini memungkinkan debugger untuk membaca setiap instruksi sebelum aplikasi memprosesnya.Semua objek di Roblox bertindak seperti proses dan setiap instruksi jalankan (atau 'kode') yang dapat di debug jika diperlukan.
  *   Ini bisa membantu untuk plugin yang perlu membedakan objek serupa dari satu sama lain (seperti objek yang berbagi nama yang sama).

Instance:GetDebugId

scopeLength

Kembalikan string terkode dari ID debug yang digunakan secara internal oleh Roblox.

GetDescendants is often used to do something to all the descendants that are a
particular type of object. The code in this example uses GetDescendants and
`Class.Instance:IsA()` to find all of the parts in the workspace and turns
them green.

Metode objek ini mem返回 array yang berisi semua keturunan dari objek itu.Tidak seperti `Class.Instance:GetChildren()` , yang hanya mengembalikan anak-anak langsung dari objek, metode ini menemukan setiap anak dari objek, setiap anak dari anak-anak itu, dan seterusnya.

Instance:GetDescendants

Sebuah array yang berisi keturunan instansi.

Kembalikan array yang berisi semua keturunan instansi.

This code sample demonstrates the behavior of `Class.Instance:GetFullName()`.
It shows how the function behaves when called on an object not in the
`DataModel` hierarchy, and it also shows how the return value does not escape
special characters.

This code sample re-implements the `Class.Instance:GetFullName()` function in
Lua.

Kembalikan string yang menjelaskan leluhur instansi.String adalah koncatenasi dari `Class.Instance.Name|Name` objek dan leluhurnya, dipisahkan oleh periode.The `Class.DataModel` ( `game` ) tidak dipertimbangkan.Sebagai contoh, `Class.Part` di `Class.Workspace` mungkin kembali `Class.Workspace.Part` .

  Ketika dipanggil pada `Class.Instance` yang bukan keturunan dari `Class.DataModel` , fungsi ini mempertimbangkan semua nenek moyang hingga dan termasuk yang paling atas tanpa `Class.Instance.Parent|Parent` .

  Fungsi ini berguna untuk pencatatan dan debugging.Anda tidak boleh mencoba memecahkan string yang dikembalikan untuk operasi yang berguna; fungsi ini tidak melarikan periode (atau simbol lain) dalam nama objek.Dengan kata lain, meskipun outputnya sering tampak menjadi identifikasi Luau yang valid, tidak dijamin.

Instance:GetFullName

Kembalikan string yang menjelaskan leluhur instansi.

Metode ini mengembalikan nilai gaya atau secara eksplisit dimodifikasi dari properti yang ditentukan, atau nilai properti default jika belum ditata/dimodifikasi.Ini berbeda sedikit dari mengakses nilai properti secara langsung, seperti `[GuiObject].Rotation` , yang men返ikan nilai default atau modifikasi properti.

  ```lua
  local Players = game:GetService("Players")
  local ReplicatedStorage = game:GetService("ReplicatedStorage")

  local player = Players.LocalPlayer
  local playerGui = player.PlayerGui
  local HUDContainer = playerGui:WaitForChild("HUDContainer")

  local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
  local rule = coreSheet:FindFirstChildWhichIsA("StyleRule")
  rule.Selector = "TextButton"

  -- Referensi ke tombol
  local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

  print(button:GetStyled("Rotation")) --> 0 (nilai default)
  print(button.Rotation) --> 0 (nilai default)

  -- Terapkan rotasi melalui properti aturan gaya
  rule:SetProperty("Rotation", 30)

  print(button:GetStyled("Rotation")) --> 30 (nilai bergaya berdasarkan aturan)
  print(button.Rotation) --> 0 (nilai default)

  -- Secara eksplisit mengubah/menghapus properti berstyling
  button.Rotation = 45

  print(button:GetStyled("Rotation")) --> 45 (nilai yang dimodifikasi)
  print(button.Rotation) --> 45 (modified value)
  ```

Instance:GetStyled

Nilai bergaya atau secara eksplisit dimodifikasi dari properti yang ditentukan, atau nilai properti default jika belum diubah/dimodifikasi.

Kembalikan nilai bergaya atau secara eksplisit dimodifikasi dari properti yang ditentukan, atau nilai properti default jika belum diberi gaya/dimodifikasi.

Metode ini men返回事件 yang berperilaku persis seperti event `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`, kecuali bahwa itu hanya menembak ketika properti gaya yang diberikan berubah.Secara umum, ide yang baik adalah menggunakan metode ini alih-alih koneksi ke `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` dengan fungsi yang memeriksa nama properti.Panggilan berikutnya ke metode ini pada objek yang sama dengan nama properti yang sama mengembalikan peristiwa yang sama.

  Perhatikan bahwa acara ini tidak akan mengirimkan argumen ke fungsi terhubung, jadi nilai properti yang diubah harus dibaca langsung dalam skrip.

  ```lua
  local Players = game:GetService("Players")

  local player = Players.LocalPlayer
  local playerGui = player.PlayerGui
  local HUDContainer = playerGui:WaitForChild("HUDContainer")
  local meterBar = HUDContainer.MeterBar

  local function stylePropertyChanged()
  	print("Style property changed!")
  end

  meterBar:GetStyledPropertyChangedSignal("AnchorPoint"):Connect(stylePropertyChanged)
  ```

Instance:GetStyledPropertyChangedSignal

property

Nama properti gaya untuk mendengarkan perubahan.

Peristiwa yang menembak ketika properti gaya yang diberikan berubah.

Metode ini mengembalikan array tag yang diterapkan pada instans yang diberikan, sebagai string.Anda dapat menambahkan tag di Studio di jendela [Properti](/studio/properties) atau saat menjalankan dengan `Class.Instance:AddTag()|AddTag()` .

  Metode ini berguna ketika Anda ingin melakukan sesuatu dengan beberapa tag pada instan sekaligus.Namun, tidak efisien menggunakan metode ini untuk memeriksa keberadaan tag tunggal; sebagai gantinya, gunakan `Class.Instance:HasTag()|HasTag()` untuk memeriksa tag khusus.

Instance:GetTags

Mendapatkan array dari semua tag yang diterapkan ke instansi.

Metode ini mengembalikan `true` jika tag yang disediakan telah ditambahkan ke objek.Anda dapat menambahkan tag baik di Studio di jendela [Properti](/studio/properties) atau saat menjalankan dengan `Class.Instance:AddTag()|AddTag()`.

Instance:HasTag

Periksa apakah instansi memiliki tag yang diberikan.

Instance

`Instance` adalah kelas dasar untuk semua kelas dalam hierarki kelas Roblox yang dapat menjadi bagian dari pohon `Class.DataModel`.

ScreenGui

Rangkuman

Properti

Properti

Properti

Metode

Acara

Acara

Properti

Metode

Acara