`Class.BillboardGui` adalah wadah untuk objek UI yang muncul di ruang 3D
namun selalu menghadap kamera. Posisi wadah ini relatif terhadap induk
`Class.BasePart` atau `Class.Attachment` (atau
`Class.BillboardGui.Adornee|Adornee`). Untuk `Class.BasePart|BaseParts`, properti
`Class.BasePart.Position|Position` digunakan, sementara untuk
`Class.Attachment|Attachments`, properti
`Class.Attachment.WorldPosition|WorldPosition` digunakan.

<img src="/assets/ui/in-experience/BillboardGui-Diagram.jpg" width="800" alt="BillboardGui dengan TextLabel yang menggambarkan konsol layar di atasnya." />

Properti `Class.BillboardGui.Size|Size` dari billboard bekerja sedikit
dengan cara berbeda dibandingkan dengan `Class.GuiObject.Size`. Sementara komponen **offset** berfungsi
sama, komponen **scale** digunakan sebagai ukuran stud dalam ruang 3D.

Saat membuat `Class.BillboardGui` yang ukuran-scaled yang berisi
`Class.TextLabel`, berguna untuk mengaktifkan properti
`Class.TextLabel.TextScaled|TextScaled` supaya teksnya skala bersama
canvas billboard saat jarak kamera berubah.

Catatan bahwa elemen UI interaktif seperti `Class.ImageButton|ImageButtons` dan
`Class.TextButton|TextButtons` di dalam `Class.BillboardGui` hanya akan menerima
input pengguna jika mereka diparent ke `Class.PlayerGui`, biasanya dengan
menempatkan `Class.BillboardGui` di dalam `Class.StarterGui`. Properti
`Class.BillboardGui.Adornee|Adornee` dapat digunakan untuk menargetkan sebuah bagian atau
attachment di dunia 3D sementara `Class.BillboardGui` itu sendiri tetap di
`Class.PlayerGui`.

Lihat [UI Dalam-Pengalaman](/ui/in-experience-containers#billboard-ui)
untuk panduan bekerja dengan wadah `Class.BillboardGui`.

##### Perilaku Cache

Untuk membantu meningkatkan kinerja, tampilan `Class.BillboardGui` dicache
sampai salah satu dari berikut terjadi, setelah itu tampilan akan dihitung
kembali pada frame rendering berikutnya.

- Sebuah keturunan ditambahkan atau dihapus dari `Class.BillboardGui`.
- Sebuah properti dari keturunan `Class.BillboardGui` berubah.
- Sebuah properti dari `Class.BillboardGui` itu sendiri berubah.


BillboardGui

Mengontrol apakah keturunan akan menerima peristiwa input. Jika
`Class.BillboardGui` mengandung `Class.GuiButton`, tombol tersebut
akan menjadi klik hanya jika `Class.BillboardGui.Active|Active` diatur ke `true`
di kedua `Class.BillboardGui` **dan** tombol.

Catatan bahwa elemen UI interaktif seperti `Class.ImageButton|ImageButtons`
dan `Class.TextButton|TextButtons` di dalam `Class.BillboardGui` hanya
akan menerima input pengguna jika mereka ditempatkan di dalam `Class.PlayerGui`,
yang biasanya ditempatkan dalam `Class.StarterGui`.
Properti `Class.BillboardGui.Adornee|Adornee` dapat digunakan untuk menargetkan
sebuah bagian atau attachment di dunia 3D sementara `Class.BillboardGui`
diri tetap berada di dalam `Class.PlayerGui`.


BillboardGui.Active

Mengontrol apakah keturunan akan menerima peristiwa input.


Menetapkan `Class.BasePart` atau `Class.Attachment` target yang menjadi
acuan posisi `Class.BillboardGui`, mengesampingkan bagian atau
attachment induk.


BillboardGui.Adornee

Menetapkan bagian atau attachment target yang menjadi acuan posisi
`Class.BillboardGui`.


Properti ini menentukan apakah `Class.BillboardGui` selalu
tersebut dirender di atas objek 3D lainnya.

Ketika diatur ke `false` (default), `Class.BillboardGui` dirender seperti
konten 3D lainnya dan akan terhalangi oleh objek 3D lainnya. Ketika diatur ke `true`, `Class.BillboardGui`
sentuh selalu dirender di atas konten 3D dan tampilan berubah secara signifikan:

- Warna cocok dengan tampilan di dalam `Class.ScreenGui`.
- Teks mungkin muncul lebih tajam pada perangkat DPI tinggi.
- `Class.BillboardGui.LightInfluence|LightInfluence` diperlakukan seolah-olah
  itu `0`.
- `Class.BillboardGui.Brightness|Brightness` tidak memiliki efek.


BillboardGui.AlwaysOnTop

Menentukan apakah `Class.BillboardGui` akan selalu dirender di atas
objek 3D lainnya.


Properti ini menentukan faktor di mana cahaya wadah `Class.BillboardGui`
diskalakan saat
`Class.BillboardGui.LightInfluence|LightInfluence` adalah `0`. Secara default,
properti ini adalah `1` dan dapat diatur pada angka antara `0` dan `1000`.
Dengan memodifikasi properti ini, kecerahan apparent dari
`Class.BillboardGui` dapat lebih cocok dengan lingkungannya. Sebagai
contoh, sebuah billboard video dapat dibuat lebih cerah di dalam ruangan gelap dengan
meningkatkan `Class.BillboardGui.Brightness|Brightness` menjadi `10`.

Catatan bahwa `Class.BillboardGui.Brightness|Brightness` tidak dapat diakses di
Studio dan tidak berpengaruh ketika baik
`Class.BillboardGui.LightInfluence|LightInfluence` adalah `1` atau
`Class.BillboardGui.AlwaysOnTop|AlwaysOnTop` adalah `true`.


BillboardGui.Brightness

Menentukan faktor di mana cahaya wadah `Class.BillboardGui`
diskalakan saat `Class.BillboardGui.LightInfluence|LightInfluence` adalah `0`.


Ketika diatur ke `true` (default), bagian dari `Class.GuiObject|GuiObjects`
yang terletak di luar perbatasan kanvas `Class.BillboardGui` tidak akan
digambar.

Bahkan ketika properti ini adalah `false`, `Class.GuiObject|GuiObjects` yang
**sepenuhnya** di luar kanvas tidak akan dirender.


BillboardGui.ClipsDescendants

Apakah bagian dari `Class.GuiObject|GuiObjects` yang terletak di luar
perbatasan kanvas `Class.BillboardGui` akan digambar.


Jarak saat ini dalam stud di mana `Class.BillboardGui` berada dari
kamera pemain. Peristiwa yang berubah tidak akan terpicu untuk properti ini
kecuali `Class.BillboardGui.DistanceStep|DistanceStep` lebih dari `0`.


BillboardGui.CurrentDistance

Jarak saat ini dalam stud di mana `Class.BillboardGui` berada dari
kamera pemain.


Menentukan jarak dalam stud di mana `Class.BillboardGui` akan
berhenti mengeskalasi lebih besar dalam ukuran relatif terhadap kamera
sekarang pemain, dengan default `0`. Jika `Class.BillboardGui.CurrentDistance|CurrentDistance` dari
`Class.BillboardGui` di bawah nilai ini, ia tidak akan mengeskalasi
lebih besar dari yang seharusnya pada jarak ini.


BillboardGui.DistanceLowerLimit

Menentukan jarak dalam stud di mana `Class.BillboardGui` akan
berhenti mengeskalasi lebih besar dalam ukuran.


Menentukan ukuran `Class.BillboardGui.CurrentDistance|CurrentDistance`
peningkatan dan penurunan dalam stud saat kamera pemain bergerak lebih dekat dan
jauh dari `Class.BillboardGui`. Properti ini defaultnya adalah `0`.


BillboardGui.DistanceStep

Menentukan ukuran `Class.BillboardGui.CurrentDistance|CurrentDistance`
peningkatan dan penurunan dalam stud saat kamera pemain bergerak lebih dekat dan
jauh dari `Class.BillboardGui`.


Menentukan jarak dalam stud di mana `Class.BillboardGui` akan
berhenti mengeskalasi lebih kecil dalam ukuran relatif terhadap kamera
sekarang pemain. Jika `Class.BillboardGui.CurrentDistance|CurrentDistance` dari
`Class.BillboardGui` berada di atas nilai ini, ia tidak akan mengeskalasi
lebih kecil dari yang seharusnya pada jarak ini.

Properti ini diabaikan jika nilai kurang dari `0`. Nilai defaultnya
adalah `-1`, yang berarti properti diabaikan secara default.


BillboardGui.DistanceUpperLimit

Menentukan jarak dalam stud di mana `Class.BillboardGui` akan
berhenti mengeskalasi lebih kecil dalam ukuran.


Properti ini menentukan bagaimana `Class.BillboardGui` teroffset dari
`Class.BillboardGui.Adornee|Adornee`, relatif terhadap orientasi
`Class.Camera`, dalam unit setengah dimensi dari kotak
pengikat yang diselaraskan dengan `Class.Camera`.

Lihat juga `Class.BillboardGui.StudsOffset|StudsOffset` yang bekerja
mirip tetapi menggunakan unit stud, atau
`Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace` yang
bekerja dengan cara serupa kecuali orientasi offset adalah relatif terhadap
sumbu global.


BillboardGui.ExtentsOffset

Menentukan bagaimana `Class.BillboardGui` teroffset dari
`Class.BillboardGui.Adornee|Adornee`, relatif terhadap orientasi
`Class.Camera`, dalam unit setengah dimensi dari kotak
pengikat yang diselaraskan dengan `Class.Camera`.


Properti ini menentukan bagaimana `Class.BillboardGui` teroffset dari
`Class.BillboardGui.Adornee|Adornee`, relatif terhadap sumbu global,
dalam unit setengah dimensi dari kotak pengikat yang diselaraskan dengan sumbu.

Lihat juga `Class.BillboardGui.StudsOffset|StudsOffset` yang berfungsi
mirip tetapi menggunakan unit stud, atau
`Class.BillboardGui.ExtentsOffset|ExtentsOffset` yang bekerja dengan cara serupa
kecuali orientasi offset adalah relatif terhadap `Class.Camera`.


BillboardGui.ExtentsOffsetWorldSpace

Menentukan bagaimana `Class.BillboardGui` teroffset dari
`Class.BillboardGui.Adornee|Adornee`, relatif terhadap sumbu global,
dalam unit setengah dimensi dari kotak pengikat yang diselaraskan dengan sumbu.


Mengontrol seberapa besar `Class.BillboardGui` dipengaruhi oleh pencahayaan
lingkungan, dalam rentang dari `0` hingga `1`. Mengatur ini ke `1` berarti
bahwa pencahayaan sekitar memiliki kendali penuh atas tampilan, sementara
pengaturannya ke `0` berarti pencahayaan tidak memberikan efek.


BillboardGui.LightInfluence

Mengontrol seberapa besar `Class.BillboardGui` dipengaruhi oleh pencahayaan
lingkungan.


Properti ini mengontrol seberapa jauh dari kamera `Class.BillboardGui`
akan ditampilkan sebelum ia berhenti merender. Sebuah nilai `0` atau `inf`
(default) berarti tidak ada batas dan ia akan merender tanpa batas jauh.

Untuk `Class.BillboardGui|BillboardGuis` yang muncul di luar ruangan, disarankan
untuk `Class.BillboardGui.MaxDistance|MaxDistance` cukup tinggi
agar UI wadah cukup kecil di layar saat muncul atau menghilang,
meminimalkan efek pop‑in/out yang mendadak.


BillboardGui.MaxDistance

Mengontrol seberapa jauh `Class.BillboardGui` dapat ditampilkan sebelum
berhenti merender.


Digunakan oleh skrip untuk menyembunyikan `Class.BillboardGui` dari pemain tertentu.

Untuk menyembunyikan `Class.BillboardGui` dari lebih dari satu pemain,
letakkan di dalam `Class.StarterGui` dan gunakan skrip untuk mengatur
properti `Class.BillboardGui.Enabled|Enabled` sesuai apakah
`Class.Players.LocalPlayer|LocalPlayer` dapat melihatnya. Properti
`Class.BillboardGui.Adornee|Adornee` dapat digunakan untuk menyematkan
`Class.BillboardGui` ke `Class.BasePart` atau `Class.Attachment` di dalam
`Class.Workspace`, daripada memparentingnya.


BillboardGui.PlayerToHideFrom

Digunakan oleh skrip untuk menyembunyikan `Class.BillboardGui` dari pemain tertentu.


Mengontrol ukuran yang dimiliki `Class.BillboardGui` di layar.
Berbeda dengan `Class.GuiObject.Size`, komponen
[scale](/ui/position-and-size#size) dari properti ini
mengatur ukuran stud billboard di ruang 3D.


BillboardGui.Size

Mengontrol ukuran yang dimiliki `Class.BillboardGui` di layar.


Sebuah offset 2D dalam unit relatif ukuran yang berfungsi seperti titik jangkar. Ini
bisa digunakan dengan cara yang mirip dengan properti `Class.GuiObject.AnchorPoint`, tetapi
nilainya berbeda.

<table size="small">
<thead>
<th>Ukuran Offset</th>
<th>Penjelasan</th>
</thead>
<tbody>
<tr>
<td><code>0, 0</code></td>
<td>Default di mana UI akan dijangkar di pusatnya.</td>
</tr>
<tr>
<td><code>0.5, 0.5</code></td>
<td>UI akan dijangkar di sudut kiri bawah.</td>
</tr>
<tr>
<td><code>0.5, -0.5</code></td>
<td>UI akan dijangkar di sudut kiri atas.</td>
</tr>
<tr>
<td><code>-0.5, 0.5</code></td>
<td>UI akan dijangkar di sudut kanan atas.</td>
</tr>
<tr>
<td><code>-0.5, -0.5</code></td>
<td>UI akan dijangkar di sudut kanan bawah.</td>
</tr>
</tbody>
</table>

Lihat pula `Class.BillboardGui.StudsOffset|StudsOffset`,
`Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace`,
`Class.BillboardGui.ExtentsOffset|ExtentsOffset`, dan
`Class.BillboardGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace` yang
adalah properti offset yang bekerja di ruang 3D.


BillboardGui.SizeOffset

Sebuah offset 2D dalam unit relatif ukuran yang berfungsi seperti titik jangkar.


Properti ini menentukan bagaimana `Class.BillboardGui` teroffset dari
`Class.BillboardGui.Adornee|Adornee` dalam stud, relatif terhadap
orientasi `Class.Camera`.

Lihat juga `Class.BillboardGui.StudsOffsetWorldSpace|StudsOffsetWorldSpace`
yang bekerja dengan cara serupa kecuali orientasi offset terkait dengan sumbu
global.


BillboardGui.StudsOffset

Menentukan bagaimana `Class.BillboardGui` teroffset dari
`Class.BillboardGui.Adornee|Adornee` dalam stud, relatif terhadap
orientasi `Class.Camera`.


Properti ini menentukan bagaimana `Class.BillboardGui` teroffset dari
`Class.BillboardGui.Adornee|Adornee` dalam stud, relatif terhadap sumbu
global.

Lihat juga `Class.BillboardGui.StudsOffset|StudsOffset` yang bekerja
mirip tetapi orientasi offsetnya relatif terhadap `Class.Camera`.


BillboardGui.StudsOffsetWorldSpace

Menentukan bagaimana `Class.BillboardGui` teroffset dari
`Class.BillboardGui.Adornee|Adornee` dalam stud, relatif terhadap sumbu
global.


Sebuah wadah untuk `Class.GuiObject|GuiObjects` yang dirender di ruang 3D menghadap
tempat kamera.


**LayerCollector** adalah kelas dasar dari wadah UI 2D yang merender
`Class.GuiObject` keturunan, seperti `Class.ScreenGui`.

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

- Sebuah keturunan ditambahkan atau dihapus darinya.
- Sebuah properti dari keturunan berubah.
- Sebuah properti dari `Class.LayerCollector` itu sendiri berubah.

LayerCollector:GetLayoutNodeTree

LayerCollector

Mengubah visibilitas dari `Class.LayerCollector` ini. Ketika `false`,
konten UI tidak akan dirender, memproses input pengguna, atau memperbarui
sebagai respons terhadap perubahan.

LayerCollector.Enabled

Mengubah visibilitas dari `Class.LayerCollector` ini.

Ketika diatur ke `false` dan `Class.LayerCollector` ini adalah anak langsung
sebuah `Class.StarterGui`, ia hanya akan mengkloning ke setiap `Class.PlayerGui`
pemain satu kali dan tidak akan dihapus ketika karakter pemain respawn.

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

LayerCollector.ResetOnSpawn

Menentukan apakah `Class.LayerCollector` reset (menghapus dirinya sendiri dan
mengkloning kembali ke `Class.PlayerGui` pemain) setiap kali karakter pemain
respawn.

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

Dengan `Enum.ZIndexBehavior.Sibling` (default), anak selalu dirender di atas
tempat orang tua mereka, dan `Class.GuiObject.ZIndex|ZIndex` digunakan untuk memutuskan
urutan di mana anak dari satu objek UI akan dirender satu sama lain.

`Enum.ZIndexBehavior.Global` mengurutkan semua keturunan sesuai dengan
`Class.GuiObject.ZIndex|ZIndex`, kemudian memecahkan ikatan menggunakan urutan
hirarki. Akibatnya, keturunan dari `Class.GuiObject` perlu memiliki
nilai `Class.GuiObject.ZIndex|ZIndex` yang setidaknya sama tingginya dengan
orang tua, atau mereka akan dirender di bawah orang tua mereka.


LayerCollector.ZIndexBehavior

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


Kelas dasar dari wadah UI 2D yang merender `Class.GuiObject|GuiObjects` dalam lapisan.

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


Acara ini terjadi ketika pemilihan gamepad bergerak ke, meninggalkan, atau berubah
di dalam `Class.GuiBase2d` yang terhubung atau keturunan manapun
`Class.GuiObject|GuiObjects`. Ketika sorotan pemilihan bergerak ke sebuah
`Class.GuiObject`, acara ini menggelembung dari `Class.GuiObject` tersebut ke semua
nenek moyangnya, memberitahukan mereka bahwa pemilihan telah
berubah/masuk/keluar ke sebuah `Class.GuiObject` dalam pohon keturunannya.


GuiBase2d.SelectionChanged

amISelected

Benar jika pemilihan baru cocok dengan GuiBase2d yang terpasang.


previousSelection

newSelection

Ditembak ketika pemilihan gamepad bergerak ke, meninggalkan, atau berubah di dalam
`Class.GuiBase2d` yang terhubung atau keturunan manapun
`Class.GuiObject|GuiObjects`.


GuiBase2d

`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` adalah properti hanya-baca
yang menyediakan posisi layar dari elemen `Class.GuiBase2d` dalam piksel. Ini mewakili posisi piksel sebenarnya di mana elemen
merender sebagai hasil dari ukuran dan posisi nenek moyangnya. 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 viewport
`Enum.ScreenInsets|CoreUISafeInsets`. Titik asal dari sistem koordinat ini terletak di sudut kiri bawah
bar 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 yang menunjukkan asal sistem koordinat AbsolutePosition." />

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


GuiBase2d.AbsolutePosition

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


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

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


GuiBase2d.AbsoluteRotation

Menggambarkan rotasi layar sebenarnya dari elemen `Class.GuiBase2d`, dalam
degree.


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

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


GuiBase2d.AbsoluteSize

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


Ketika diatur ke `true`, lokalisasi akan diterapkan pada `Class.GuiBase2d`
dan keturunannya. Masukan yang digunakan untuk lokalisasi adalah kumpulan yang sama dari
entri yang dikembalikan oleh `Class.LocalizationService:GetTableEntries()`. Entri dengan `Class.GuiBase2d.AutoLocalize|AutoLocalize` diaktifkan secara otomatis
 diterjemahkan kembali setelah tabel cloud dimuat jika perlu.

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


GuiBase2d.AutoLocalize

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


Properti ini secara otomatis diatur ke true ketika tabel lokalisasi
`Class.LocalizationTable.Root` menargetkan objek ini, atau nenek moyang objek ini. `Class.LocalizationTable|LocalizationTables` dengan
properti `Class.LocalizationTable.Root` yang mengarah pada sebuah instance akan
melokalisasi semua `Class.TextLabel.TextButton` yang merupakan keturunan dari instance root.


GuiBase2d.Localize

Secara otomatis diatur ke true ketika tabel lokalisasi
`Class.LocalizationTable.Root` menargetkan objek ini, atau nenek moyang objek ini.


Referensi ke `Class.LocalizationTable` yang digunakan untuk menerapkan lokalisasi
otomatis pada `Class.GuiBase2d` ini dan keturunannya.
`Class.GuiBase2d.AutoLocalize|AutoLocalize` harus diatur ke `true` pada
`Class.GuiBase2d` dan nenek moyangnya agar lokalisasi otomatis dapat diterapkan.

Anda dapat menetapkan ini untuk merujuk ke `Class.LocalizationTable` di mana saja dalam
`Class.DataModel`. Objek `Class.GuiBase2d` dan semua anaknya
akan mencoba menggunakan `Class.LocalizationTable` tertentu itu dan nenek moyangnya
untuk penggantian teks otomatis sebelum menggunakan tabel di bawah
`Class.LocalizationService` dalam urutan yang tidak terdefinisi dan tabel cloud.

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

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


GuiBase2d.RootLocalizationTable

Referensi ke `Class.LocalizationTable` yang digunakan untuk menerapkan lokalisasi
otomatis pada `Class.GuiBase2d` ini dan keturunannya.


Menyesuaikan perilaku pemilihan gamepad ke arah bawah.


GuiBase2d.SelectionBehaviorDown

Menyesuaikan perilaku pemilihan gamepad ke arah kiri.


GuiBase2d.SelectionBehaviorLeft

Menyesuaikan perilaku pemilihan gamepad ke arah kanan.


GuiBase2d.SelectionBehaviorRight

Menyesuaikan perilaku pemilihan gamepad ke arah atas.


GuiBase2d.SelectionBehaviorUp

Memungkinkan kustomisasi tentang bagaimana pemilihan gamepad dapat bergerak antara
tombol, yang merupakan keturunan dari kelompok pemilihan, meninggalkan kelompok,
dan memilih tombol lainnya.

Mengatur `Class.GuiBase2d.SelectionGroup|SelectionGroup` ke `true` memperlihatkan
`Class.GuiBase2d.SelectionBehaviorUp|SelectionBehaviorUp`,
`Class.GuiBase2d.SelectionBehaviorDown|SelectionBehaviorDown`,
`Class.GuiBase2d.SelectionBehaviorLeft|SelectionBehaviorLeft`, dan
`Class.GuiBase2d.SelectionBehaviorRight|SelectionBehaviorRight`
properti. Untuk perilaku pemilihan ini, pengaturan `Enum.SelectionBehavior.Escape` (default) berarti pemilihan gamepad
mencoba terlebih dahulu mencari pemilihan dalam kelompok pemilihan dan hanya bergerak
keluar jika tidak menemukan tombol yang sesuai. Sebaliknya, pengaturan
`Enum.SelectionBehavior.Stop` berarti pemilihan gamepad hanya melihat dalam kelompok pemilihan
 dan tidak bergerak keluar dari kelompok dari arah perilaku pemilihan.


GuiBase2d.SelectionGroup

Memungkinkan kustomisasi pergerakan pemilihan gamepad.


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


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


GuiBase

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

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

Menunjukkan cara mendeteksi perubahan pada leluhur sebuah instance dengan menghubungkan ke
`Class.Instance.AncestryChanged` event.

Parent dari ChangingPart diatur ke nilai yang berbeda seiring waktu. Parent dari
part adalah leluhur part, jadi event `Class.Instance.AncestryChanged`
akan dipicu setiap kali terjadi perubahan.


Dibakar saat instans ini diubah parent-nya atau saat salah satu nenek
moyangnya diubah parent-nya.

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

Instance.AncestryChanged

child

Instans yang properti `Class.Instance.Parent|Parent`-nya diubah,
yang bisa jadi instans ini atau nenek moyang yang lebih jauh, **tidak**
selalu instans yang terhubung dengan handler.

parent

Dibakar saat properti `Class.Instance.Parent` dari objek ini atau salah satu
nenek moyangnya diubah.

Peristiwa ini dibakar setiap kali atribut apa pun diubah pada instans,
termasuk ketika atribut diatur ke `nil`. Nama atribut yang diubah
akan diteruskan ke fungsi yang terhubung.

Sebagai contoh, cuplikan kode berikut menghubungkan fungsi `attributeChanged()`
untuk dibakar kapan pun salah satu atribut bagian diubah:

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

local part = Workspace.Part

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

part.AttributeChanged:Connect(attributeChanged)
```
Lihat juga `Class.Instance:GetAttributeChangedSignal()` yang mengembalikan sebuah
event yang dibakar saat atribut tertentu diubah.

Instance.AttributeChanged

attribute

Dibakar kapan pun atribut diubah pada `Class.Instance`.

Cuplikan ini mencetak nama objek saat mereka ditambahkan ke Workspace:


Dibakar setelah sebuah objek di-parent ke `Class.Instance` ini.

Catatan, saat menggunakan metode ini di client untuk mendeteksi objek yang
 dibuat oleh server itu perlu menggunakan `Class.Instance:WaitForChild()` saat
mengindeks keturunan objek ini. Ini karena objek dan keturunannya tidak
dijamin untuk direplikasi dari server ke client secara bersamaan. Sebagai contoh:

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

Workspace.ChildAdded:Connect(function(child)
	-- Gunakan WaitForChild() karena keturunan mungkin belum direplikasi
	local head = child:WaitForChild("Head")
end)
```
Catatan, peristiwa ini hanya beroperasi untuk anak-anak langsung dari
`Class.Instance`. Untuk sebuah peristiwa yang menangkap semua keturunan, gunakan
`Class.Instance.DescendantAdded`.

Lihat juga `Class.Instance.ChildRemoved`.

Instance.ChildAdded

Dibakar setelah sebuah objek di-parent ke `Class.Instance` ini.

Instance.childAdded

Potongan ini mencetak nama objek saat mereka dihapus dari Workspace:

Dibakar setelah seorang anak dihapus dari `Class.Instance` ini.

Dihapus berarti saat parent objek diubah dari `Class.Instance` ini ke
sesuatu selain `Class.Instance` ini. Catatan, peristiwa ini juga akan dibakar
 saat seorang anak dihancurkan (menggunakan
`Class.Instance:Destroy()`) karena fungsi hancur menetapkan parent objek ke
`nil`.

Peristiwa ini hanya beroperasi untuk anak-anak langsung dari `Class.Instance`.
Untuk sebuah peristiwa yang menangkap semua keturunan, gunakan
`Class.Instance.DescendantRemoving`.

Lihat juga `Class.Instance.ChildAdded`.

Instance.ChildRemoved

Dibakar setelah seorang anak dihapus dari `Class.Instance` ini.

Contoh berikut akan mencetak nama objek apa pun yang ditambahkan ke
Workspace:

Peristiwa ini dibakar setelah sebuah keturunan ditambahkan ke `Class.Instance`.

Karena dibakar untuk setiap keturunan, meng-parent sebuah objek ke
`Class.Instance` akan membakar peristiwa untuk objek ini dan semua keturunannya
secara terpisah.

Jika Anda hanya khawatir dengan **anak-anak langsung** dari
`Class.Instance`, gunakan `Class.Instance.ChildAdded` sebagai gantinya.

Lihat juga `Class.Instance.DescendantRemoving`.

Instance.DescendantAdded

descendant

Dibakar setelah sebuah keturunan ditambahkan ke `Class.Instance`.

Contoh berikut mencetak nama dari setiap keturunan saat sedang dihapus
 dari Workspace:

Peristiwa ini dibakar **segera sebelum** parent `Class.Instance`
berubah sehingga sebuah instans **keturunan** tidak lagi menjadi
keturunan. `Class.Instance:Destroy()|Destroy()` mengubah `Class.Instance.Parent|Parent`
menjadi `nil`, jadi memanggil metode itu pada seorang keturunan dari parent
akan menyebabkan peristiwa ini dibakar.

Karena peristiwa ini dibakar **sebelum** penghapusan keturunan, parent dari
keturunan tidak akan berubah pada saat peristiwa ini dibakar. Jika keturunan
 juga adalah **anak langsung** dari parent, peristiwa ini akan dibakar
sebelum `Class.Instance.ChildRemoved`.

Jika keturunan memiliki anak, peristiwa ini dibakar dengan keturunan terlebih dahulu,
dikuti oleh keturunannya.

#### Peringatan

Peristiwa ini dibakar dengan objek keturunan yang sedang dihapus.
Mencoba mengatur `Class.Instance.Parent|Parent` dari keturunan ke yang lain
akan gagal. Di bawah ini adalah contoh yang menunjukkan hal ini:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Jangan manipulasi parent dari keturunan dalam fungsi ini!
	-- Peristiwa ini dibakar KARENA parent telah dimanipulasi, dan perubahan belum terjadi
	-- Oleh karena itu, problematik untuk mengubah parent seperti ini:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Lihat juga `Class.Instance.DescendantAdded|DescendantAdded`.

Instance.DescendantRemoving

Dibakar segera sebelum seorang keturunan dari `Class.Instance` dihapus.

Contoh ini menunjukkan bagaimana, saat menggunakan perilaku sinyal Segera, sebuah
Instance yang dihancurkan tetap berada di tempatnya sampai fungsi yang terhubung menunggu.


Contoh ini menunjukkan bagaimana, ketika menggunakan perilaku sinyal Tertunda, sebuah Instance
 dihancurkan sebelum sinyal dipicu.


`Class.Instance` tidak akan pernah dihapus dari memori selama fungsi yang terhubung
masih menggunakannya. Namun, jika fungsi tersebut menunggu pada titik manapun,
`Class.Instance` dan keturunannya akan di-parent ke `nil`.

Jika properti `Class.Workspace.SignalBehavior` diatur ke
`Enum.SignalBehavior.Immediate`, peristiwa ini dibakar segera sebelum
`Class.Instance` atau salah satu nenek moyangnya dihancurkan dengan
`Class.Instance:Destroy()`.

Jika properti `Class.Workspace.SignalBehavior` diatur ke
`Enum.SignalBehavior.Deferred`, peristiwa ini dibakar pada titik pemulihan
b berikutnya, yang akan terjadi setelah `Class.Instance` atau salah satu nenek moyangnya dihancurkan dengan
`Class.Instance:Destroy()`.

Dengan perilaku `Enum.SignalBehavior.Deferred|Deferred`, menghubungkan skrip
dengan peristiwa `Class.Instance.Destroying` sendiri adalah problematik,
karena skrip akan dihancurkan sebelum callback dapat dipanggil (berarti tidak
akan dieksekusi).

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

Instance.Destroying

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

Peristiwa ini dibakar kapan pun properti gaya apa pun diubah pada instans,
termasuk ketika sebuah 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("Properti gaya diubah")
end

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

Instance.StyledPropertiesChanged

Dibakar kapan pun properti gaya apa pun diubah pada instans, termasuk
ketika sebuah properti diatur ke `nil`.

Metode ini memberi tag pada instance, tanpa efek jika tag sudah
 diterapkan. Menambahkan tag dengan sukses akan memicu sinyal yang dibuat untuk
`Class.CollectionService:GetInstanceAddedSignal()` dengan tag yang diberikan.

#### Peringatan

- Tag-tag dari sebuah instance yang ditambahkan di sisi klien akan diabaikan jika
  server menghapus atau menambah tag pada instance tersebut karena server
  mereplikasi semua tag bersama-sama dan menimpa tag sebelumnya.

- Ketika memberi tag pada sebuah instance, umum untuk menggunakan beberapa sumber
  daya untuk memberikan fungsionalitas kepada tag tersebut, misalnya sambungan
  peristiwa atau tabel. Untuk mencegah kebocoran memori, merupakan ide baik
  untuk membersihkannya (putuskan sambungan, atur ke `nil`, dll.) ketika
  tidak lagi dibutuhkan untuk tag. Ini dilakukan saat memanggil
  `Class.Instance:RemoveTag()`, memanggil
  `Class.Instance:Destroy()`, atau dalam fungsi yang terhubung ke sinyal
  yang dikembalikan oleh`Class.CollectionService:GetInstanceRemovedSignal()`.

Instance:AddTag

Fungsi anak mengembalikan array dari anak-anak objek.

Instance:children

Mengembalikan array dari anak-anak objek.

Metode ini menghancurkan semua anak dari sebuah instance dan keturunannya.

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

-- Tambahkan beberapa kilau
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 dan keturunan, gunakan
`Class.Instance:GetChildren()` atau `Class.Instance:GetDescendants()` untuk
menelusuri anak-anak/keturunan tersebut dan memilih apa yang akan dihancurkan.
Sebagai contoh, sampel kode berikut akan menghancurkan semua
`Class.BasePart|BaseParts` yang 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

Metode ini menghancurkan semua anak dari sebuah instance.

Menunjukkan cara mengkloning sebuah model menggunakan `Class.Instance:Clone()`.

`Clone()` membuat salinan dari sebuah instance dan semua keturunannya,
mengabaikan semua instance yang tidak
`Class.Instance.Archivable|Archivable`. Salinan dari instance root dikembalikan
oleh metode ini dan `Class.Instance.Parent|Parent`-nya diatur menjadi
`nil`. Perlu dicatat bahwa jika instance itu sendiri memiliki
`Class.Instance.Archivable|Archivable` diatur menjadi `false`, metode ini akan
mengembalikan `nil`.

Jika properti referensi seperti `Class.ObjectValue.Value` diatur pada
instance yang dikloning, nilai dari properti salinan tergantung pada
nilai asli:

- Jika sebuah properti referensi merujuk pada instance yang **juga**
dikloning, salinan akan merujuk pada salinan tersebut.
- Jika sebuah properti referensi merujuk pada instance yang **tidak**
dikloning, nilai yang sama dipertahankan di dalam salinan.

Instance:Clone

Buat salinan dari sebuah instance dan semua keturunannya, mengabaikan instance
 yang tidak `Class.Instance.Archivable|Archivable`.

Instance:clone

Menunjukkan cara menghancurkan sebuah Part menggunakan fungsi `Class.Instance:Destroy()`.

Fungsi ini adalah cara yang benar untuk membuang objek yang tidak lagi
dibutuhkan.


Mengatur properti `Class.Instance.Parent` menjadi `nil`, mengunci
properti `Class.Instance.Parent`, memutus semua koneksi, dan memanggil
`Destroy()` pada semua anak. Metode ini adalah cara yang benar untuk menghapus
objek yang tidak lagi diperlukan.

Menghapus objek yang tidak diperlukan sangat penting, karena objek dan
koneksi yang tidak dibutuhkan dapat menghabiskan memori yang dapat
menyebabkan masalah kinerja yang serius seiring waktu.

Sebagai praktik terbaik setelah memanggil `Destroy()` pada sebuah objek,
aturkan variabel apa pun yang merujuk ke objek (atau keturunannya) ke `nil`.
Ini mencegah kode Anda mengakses hal yang berkaitan dengan objek tersebut.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Jangan lakukan ini:
print(part.Name)  --> "Hello, world"
-- Lakukan ini untuk mencegah baris di atas bekerja:
part = nil
```
Setelah `Class.Instance` dihancurkan oleh metode ini, tidak dapat digunakan
kembali karena properti `Class.Instance.Parent` dikunci. Untuk
**sementara** menghapus objek alih-alih menghancurkannya, atur
`Class.Instance.Parent|Parent` menjadi `nil`. Sebagai contoh:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Untuk menghancurkan objek setelah jangka waktu tertentu, gunakan
`Class.Debris:AddItem()`.

Instance:Destroy

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

Instance:destroy

Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Instance.Name`-nya sama dengan nama yang diberikan.

Metode ini bekerja ke atas, artinya mulai dari `Class.Instance.Parent`
yang dekat dengan instance dan bekerja ke atas menuju `Class.DataModel`. Jika tidak
ada nenek moyang yang cocok ditemukan, metode ini mengembalikan `nil`.

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

```
local car = object:FindFirstAncestor("Car")
```
Untuk varian dari metode ini yang menemukan nenek moyang dari kelas tertentu,
lihat `Class.Instance:FindFirstAncestorOfClass()` dan
`Class.Instance:FindFirstAncestorWhichIsA()`.

Instance:FindFirstAncestor

name

Nama `Class.Instance.Name` yang akan dicari.

Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Instance.Name`-nya sama dengan nama yang diberikan.

Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Object.ClassName`-nya sama dengan className yang diberikan.

Metode ini bekerja ke atas, artinya mulai dari `Class.Instance.Parent`
yang dekat dengan instance dan bekerja ke atas menuju `Class.DataModel`. Jika tidak
ada nenek moyang yang cocok ditemukan, metode ini mengembalikan `nil`.

Kegunaan umum dari metode ini adalah menemukan `Class.Model` tempat
 `Class.BasePart` bernaung. Sebagai contoh:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Metode ini adalah varian dari `Class.Instance:FindFirstAncestor()` yang
memeriksa properti `Class.Object.ClassName` alih-alih `Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` juga
ada, menggunakan metode `Class.Object:IsA()` alih-alih untuk menghormati
pewarisan kelas.

Instance:FindFirstAncestorOfClass

className

Nama `Class.Object.ClassName` yang akan dicari.

Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Object.ClassName`-nya sama dengan className yang diberikan.

Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Object:IsA()` mengembalikan nilai benar untuk className yang diberikan.

Metode ini bekerja ke atas, artinya mulai dari `Class.Instance.Parent`
yang dekat dengan instance dan bekerja ke atas menuju `Class.DataModel`. Jika tidak
ada nenek moyang yang cocok ditemukan, metode ini mengembalikan `nil`.

Berbeda dengan `Class.Instance:FindFirstAncestorOfClass()`, metode ini menggunakan
`Class.Object:IsA()` yang menghormati pewarisan kelas. Sebagai contoh:

```
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 `Class.WedgePart`,
`Class.MeshPart` atau `Class.Part`.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Lihat juga `Class.Instance:FindFirstAncestor()`.

Instance:FindFirstAncestorWhichIsA

Mengembalikan nenek moyang pertama dari `Class.Instance` yang
`Class.Object:IsA()` mengembalikan nilai benar untuk className yang diberikan.

Di bawah ini akan mencari di Workspace untuk objek dengan nama "Brick". Jika ditemukan,
akan mengganti nama objek tersebut menjadi "Foo".

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

#### Memeriksa Keberadaan Objek

`FindFirstChild()` diperlukan jika Anda perlu memverifikasi sebuah objek ada
sebelum melanjutkan. Mencoba mengindeks seorang anak berdasarkan nama menggunakan
operator titik akan menghasilkan kesalahan jika anak tidak ada.

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

-- Baris berikut menghasilkan kesalahan jika bagian tidak ada di workspace
Workspace.Part.Transparency = 0.5
```
Pendekatan yang lebih baik adalah menggunakan `FindFirstChild()` untuk
pertama memeriksa `Part`, kemudian menggunakan 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 Sesuai dengan Properti

Kadang-kadang nama `Class.Instance.Name|Name` dari sebuah objek sama dengan
sebuah properti dari `Class.Instance.Parent|Parent`-nya. Saat menggunakan operator titik,
properti memiliki prioritas lebih dari anak-anak jika keduanya memiliki nama yang sama.

Pada contoh berikut, sebuah `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 pada instance
anak `Class.Folder`. Keuntungan dari menggunakan
`Class.Instance:FindFirstChild()|FindFirstChild()` adalah bahwa
pengenalan properti baru tidak mengenakan 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  -- Properti
local c2 = part:FindFirstChild("Color")  -- Folder anak
```

#### Catatan Kinerja

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

Instance:FindFirstChild

recursive

Apakah pencarian harus dilakukan secara rekursif.

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

Instance:findFirstChild

Mengembalikan anak pertama dari `Class.Instance` yang memiliki
`Class.Object.ClassName|ClassName` yang sama dengan `className` yang diberikan.
Tidak seperti `Class.Instance:FindFirstChildWhichIsA()`, metode ini hanya mengembalikan
objek yang kelasnya cocok dengan `className`, mengabaikan pewarisan kelas. Jika tidak
ada anak yang cocok ditemukan, metode ini mengembalikan `nil`.

Instance:FindFirstChildOfClass

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

Mengembalikan anak pertama dari `Class.Instance` yang
`Class.Object:IsA()` mengembalikan nilai benar untuk className yang diberikan.

Jika tidak ada anak yang cocok ditemukan, metode ini mengembalikan `nil`. Jika
argumen opsional rekursif bernilai benar, metode ini mencari semua keturunan
dari hanya anak langsung `Class.Instance`.

Tidak seperti `Class.Instance:FindFirstChildOfClass()`, metode ini menggunakan
`Class.Object:IsA()` yang menghormati pewarisan kelas. Sebagai contoh:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Oleh karena itu, sampel kode berikut akan mengembalikan anak pertama
`Class.BasePart`, terlepas dari apakah itu `Class.WedgePart`,
`Class.MeshPart`, atau `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Pengembang yang mencari anak berdasarkan nama, sebaiknya menggunakan
`Class.Instance:FindFirstChild()` sebagai gantinya.

Instance:FindFirstChildWhichIsA

Mengembalikan anak pertama dari `Class.Instance` yang
`Class.Object:IsA()` mengembalikan nilai benar untuk className yang diberikan.

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

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

Instance:FindFirstDescendant

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

Jika `Class.Instance` adalah `Class.Actor`, `Class.Actor` itu sendiri akan
 dikembalikan. Jika tidak, nenek moyang terdekat `Class.Actor` akan
 dikembalikan. Jika tidak ada nenek moyang `Class.Actor`, hasilnya adalah `nil`.

Instance:GetActor

Mengembalikan `Class.Actor` yang terkait dengan Instance, jika ada.

Metode ini mengembalikan nilai yang telah ditetapkan untuk nama atribut yang
 diberikan. Jika tidak ada atribut yang telah ditetapkan, `nil` akan dikembalikan.

Sebagai contoh, potongan kode berikut mengatur dan kemudian mengambil nilai
 atribut `InitialPosition` dari instance:

```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 mengembalikan kamus dari pasangan kunci-nilai
 untuk setiap atribut instance.

Instance:GetAttribute

Mengembalikan nilai yang telah ditetapkan untuk nama atribut yang diberikan.

Instance

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

/reference/engine/classes/BillboardGui.yaml