Sebuah objek data yang mewakili pesan obrolan teks.

Untuk mempelajari lebih lanjut tentang penggunaan TextChatMessages, lihat
[Obrolan Teks dalam Pengalaman](/chat/in-experience-text-chat).

TextChatMessage

TextChatMessage.BubbleChatMessageProperties

TextChatMessage.ChatWindowMessageProperties

Identifikasi unik untuk `Class.TextChatMessage`.

TextChatMessage.MessageId

Sebuah bidang tujuan umum untuk menyimpan data campuran tentang
`TextChatMessage`. Argumen kedua dari `Class.TextChannel:SendAsync()`
dan `Class.TextChannel:DisplaySystemMessage()` digunakan untuk mengisi
bidang ini.

Gunakan bidang ini untuk menerapkan format tambahan untuk pesan khusus dalam
callback `Class.TextChatService.OnIncomingMessage` dan
`Class.TextChannel.OnIncomingMessage`.

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

local customChannel: TextChannel = Instance.new("TextChannel")
customChannel.Parent = TextChatService:WaitForChild("TextChannels")

customChannel.OnIncomingMessage = function(message: TextChatMessage)
  if string.find(message.Metadata, "Error") then
    local overrideProperties = Instance.new("TextChatMessageProperties")
    overrideProperties.Text = string.format("<font color='rgb(255,0,0)'>%s</font>", message.Text)
    return overrideProperties
  elseif string.find(message.Metadata, "Info") then
    local overrideProperties = Instance.new("TextChatMessageProperties")
    overrideProperties.Text = string.format("<font color='rgb(0, 255, 150)'>%s</font>", message.Text)
    return overrideProperties
  end

  return nil
end

Players.LocalPlayer.CharacterAdded:Connect(function()
  customChannel:DisplaySystemMessage("Ini adalah sebuah kesalahan!", "Game.Error.Generic")
  customChannel:DisplaySystemMessage("Tidak dapat menemukan data simpan!", "Game.Error.SaveDataNotFound")

  customChannel:DisplaySystemMessage("Anda memenangkan permainan!", "Game.Info.Win")
  customChannel:DisplaySystemMessage("Anda kalah dalam permainan!", "Game.Info.Lose")
end)
```
Berikut adalah referensi dari pesan sistem default yang dikeluarkan oleh
sistem obrolan:

<table size="small">
<thead>
  <tr>
    <th>Metadata</th>
    <th>Deskripsi</th>
  </tr>
</thead>
<tbody>
  <tr>
    <td><code>Roblox.ChatTranslation.ChatWindow.SystemMessage</code></td>
    <td>Menunjukkan bahwa sistem mungkin menerjemahkan pesan obrolan untuk pemain.</td>
  </tr>
  <tr>
    <td><code>Roblox.Notification.Friend.Joined</code></td>
    <td>Ditampilkan ketika salah satu teman pemain bergabung dengan pengalaman.</td>
  </tr>
  <tr>
    <td><code>Roblox.MessageStatus.Warning.Floodchecked</code></td>
    <td>Ditampilkan ketika pesan yang dikirim pemain dibatasi oleh server.</td>
  </tr>
  <tr>
    <td><code>Roblox.MessageStatus.Warning.TextFilterFailed</code></td>
    <td>Ditampilkan ketika pesan yang dikirim pemain tidak dapat ditampilkan karena masalah penyaringan teks.</td>
  </tr>
  <tr>
    <td><code>Roblox.MessageStatus.Warning.InvalidPrivacySettings</code></td>
    <td>Ditampilkan ketika pengaturan privasi pemain menghalangi mereka untuk mengirim pesan.</td>
  </tr>
  <tr>
    <td><code>Roblox.MessageStatus.Warning.MessageTooLong</code></td>
    <td>Ditampilkan ketika pemain mengirim pesan dengan konten yang terlalu panjang.</td>
  </tr>
  <tr>
    <td><code>Roblox.MessageStatus.Warning.Unknown</code></td>
    <td>Ditampilkan ketika sistem gagal mengirim pesan pemain karena alasan yang tidak diketahui.</td>
  </tr>
  <tr>
    <td><code>Roblox.Help.Info</code></td>
    <td>Menampilkan respons dari <code>RBXHelpCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Version.Info</code></td>
    <td>Menampilkan respons dari <code>RBXVersionCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Team.Success.NowInTeam</code></td>
    <td>Ditampilkan ketika tim pemain berubah.</td>
  </tr>
  <tr>
    <td><code>Roblox.Team.Error.CannotTeamChatIfNotInTeam</code></td>
    <td>Ditampilkan ketika pemain memicu <code>RBXTeamCommand</code> <code>Class.TextChatCommand</code> tanpa berada di <code>Class.Team</code>.</td>
  </tr>
      <tr>
    <td><code>Roblox.Whisper.Info.Success</code></td>
    <td>Ditampilkan ketika pemain berhasil memulai percakapan bisikan.</td>
  </tr>
  <tr>
    <td><code>Roblox.Whisper.Welcome.Sent</code></td>
    <td>Ditampilkan ketika memasuki bisikan <code>Class.TextChannel</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Whisper.Error.CannotWhisperToSelf</code></td>
    <td>Respons kesalahan dari <code>RBXWhisperCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Whisper.Error.TargetDoesNotExist</code></td>
    <td>Respons kesalahan dari <code>RBXWhisperCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Whisper.Error.TooManyMatches</code></td>
    <td>Respons kesalahan dari <code>RBXWhisperCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Whisper.Error.Unknown</code></td>
    <td>Respons kesalahan dari <code>RBXWhisperCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Emote.Error.DoesNotExist</code></td>
    <td>Respons kesalahan dari <code>RBXEmoteCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Emote.Error.UserEmotesNotEnabled</code></td>
    <td>Respons kesalahan dari <code>RBXEmoteCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Emote.Error.TemporarilyUnavailable</code></td>
    <td>Respons kesalahan dari <code>RBXEmoteCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Emote.Error.NotSupported</code></td>
    <td>Respons kesalahan dari <code>RBXEmoteCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Emote.Error.SwitchToR15</code></td>
    <td>Respons kesalahan dari <code>RBXEmoteCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Emote.Error.AnimationPlaying</code></td>
    <td>Respons kesalahan dari <code>RBXEmoteCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Mute.Error.PlayerNotFound</code></td>
    <td>Respons kesalahan dari <code>RBXMuteCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Mute.Error.MultipleMatches</code></td>
    <td>Respons kesalahan dari <code>RBXMuteCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Mute.Error.CannotMuteSelf</code></td>
    <td>Respons kesalahan dari <code>RBXMuteCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Mute.Info.Success</code></td>
    <td>Respons sukses dari <code>RBXMuteCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Unmute.Error.PlayerNotFound</code></td>
    <td>Respons kesalahan dari <code>RBXUnmuteCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Unmute.Error.MultipleMatches</code></td>
    <td>Respons kesalahan dari <code>RBXUnmuteCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Unmute.Error.CannotMuteSelf</code></td>
    <td>Respons kesalahan dari <code>RBXUnmuteCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
  <tr>
    <td><code>Roblox.Unmute.Info.Success</code></td>
    <td>Respons sukses dari <code>RBXUnmuteCommand</code> <code>Class.TextChatCommand</code>.</td>
  </tr>
</tbody>
</table>


TextChatMessage.Metadata

Bidang tujuan umum untuk menyimpan data tambahan tentang
`Class.TextChatMessage`.

Sebuah awalan untuk ditambahkan ke pesan pengguna. Ini mendukung Teks Kaya, jadi
developer dapat mengatur properti kustom untuk teks ini untuk mendukung tag chat.

Secara default, `Class.TextChatMessage.PrefixText` adalah nama dari
`Class.TextSource`, yang merupakan `Class.Player.DisplayName` dari pengguna
terkait dengan `Class.TextSource` melalui `Class.TextSource.UserId`.

TextChatMessage.PrefixText

Sebuah awalan untuk ditambahkan ke pesan pengguna.

Menunjukkan status dari `Class.TextChatMessage`.

TextChatMessage.Status

Pesan teks yang telah disaring untuk pengguna. Pengguna yang berbeda dapat menerima
string yang berbeda dari properti ini berdasarkan aturan penyaringan. Ini bisa menjadi
string kosong.

TextChatMessage.Text

Pesan teks yang telah disaring untuk pengguna.

TextChatMessage.TextChannel

TextChatMessage.TextSource

TextChatMessage.Timestamp

Mewakili pesan teks yang telah diterjemahkan dan disaring berdasarkan
pengaturan lokal pengguna. Sistem tidak menerjemahkan pesan antara pengguna
 dengan pengaturan lokal yang sama atau menggunakan bahasa tanpa dukungan penyaringan teks, jadi properti ini bisa menjadi string kosong jika tidak ada terjemahan
yang terjadi. Untuk kustomisasi, lihat
[Customizing Translated Messages](/chat/chat-window).

TextChatMessage.Translation

Pesan teks yang telah diterjemahkan dan disaring.

Sebuah objek data yang mewakili pesan obrolan teks.

`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

Nilai yang telah ditetapkan untuk nama atribut yang diberikan. Jika tidak
 ada atribut yang telah ditetapkan, `nil` akan dikembalikan.

Mengembalikan nilai yang telah ditetapkan untuk nama atribut yang diberikan.

Metode ini mengembalikan sebuah event yang berfungsi sama dengan
event `Class.Object.Changed|Changed`, kecuali bahwa event ini hanya terpicu ketika
atribut tertentu yang diberikan berubah; secara efektif mirip dengan
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` tetapi
 untuk atribut.

Umumnya merupakan ide bagus untuk menggunakan metode ini alih-alih koneksi
ke `Class.Object.Changed|Changed` dengan sebuah fungsi yang memeriksa nama atribut.
Panggilan berikutnya ke metode ini pada objek yang sama dengan nama atribut
 yang sama mengembalikan event yang sama.

Sampel kode berikut mengembalikan sinyal yang mengaktifkan fungsi
`attributeChanged()` ketika atribut `InitialPosition` dari bagian tersebut berubah:

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

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

local function attributeChanged()
	print("Atribut telah diubah")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Lihat juga `Class.Instance.AttributeChanged` yang terpicu kapan saja ada
atribut yang diubah pada instance tersebut.

Instance:GetAttributeChangedSignal

Nama atribut yang ditentukan untuk mana sinyal perubahan sedang
 dikembalikan.

Sebuah event yang terpicu ketika atribut yang diberikan berubah.

Mengembalikan sebuah event yang terpicu ketika atribut yang diberikan
berubah.

Metode ini mengembalikan kamus dari pasangan kunci-nilai untuk setiap atribut
dimana kuncinya adalah nama atribut dan nilainya adalah nilai yang tidak `nil`.

Sebagai contoh, potongan kode berikut mengeluarkan atribut dan nilai
 dari sebuah instance:

```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 mengembalikan nilai yang telah
 ditetapkan untuk nama atribut yang diberikan.

Instance:GetAttributes

Sebuah kamus dari pasangan string → varian untuk setiap atribut dimana
string adalah nama atribut dan varian adalah nilai yang tidak nil.

Mengembalikan kamus dari atribut instance.

Di bawah ini akan mencetak nama semua objek yang saat ini ada di Workspace saat dijalankan.

Mengembalikan sebuah array (sebuah tabel yang terindeks numerik)
yang berisi semua anak langsung dari instance, atau setiap `Class.Instance`
yang `Class.Instance.Parent|Parent`-nya sama dengan objek tersebut. Array tersebut dapat
iterasi menggunakan baik loop numerik maupun loop generik:

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

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

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

-- Contoh loop generik
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " adalah anak nomor " .. i)
end
```
Perhatikan bahwa array yang dikembalikan **tidak** diurutkan dalam urutan tertentu, jadi
pengurutan manual (misalnya menggunakan `Library.table.sort()`) sangat dianjurkan untuk
mengurutkan anak-anak yang dikembalikan oleh metode ini.

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

Instance:GetChildren

Sebuah array yang berisi anak-anak instance.

Mengembalikan sebuah array yang berisi semua anak dari
 instance.

Instance:getChildren

Mengembalikan string terkode dari ID debug yang digunakan secara internal oleh Roblox. Perlu dicatat bahwa:

- Item ini dilindungi. Mencoba menggunakan ini di dalam `Class.Script` atau
  `Class.LocalScript` akan menyebabkan kesalahan.
- Sebuah ID debug adalah ID yang digunakan dalam proses debugging. Ini memungkinkan debugger untuk
  membaca setiap instruksi sebelum sebuah aplikasi memprosesnya. Semua objek di
  Roblox bertindak sebagai proses dan menjalankan instruksi (atau 'kode') yang dapat
  di-debug jika diperlukan.
- Ini bisa bermanfaat bagi plugin-plugin yang perlu membedakan objek-objek yang serupa
  satu sama lain (seperti objek yang memiliki nama yang sama).

Instance:GetDebugId

scopeLength

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

GetDescendants sering digunakan untuk melakukan sesuatu kepada semua keturunan yang merupakan
jenis objek tertentu. Kode dalam contoh ini menggunakan GetDescendants dan
`Class.Instance:IsA()` untuk menemukan semua bagian di workspace dan mengubah
warna mereka menjadi hijau.

Metode objek ini mengembalikan array yang berisi semua keturunan
 dari objek tersebut. Berbeda dengan `Class.Instance:GetChildren()`, yang hanya mengembalikan
anak langsung dari sebuah objek, metode ini menemukan setiap anak dari objek,
every child of those children, dan seterusnya.

Perhatikan bahwa array yang dikembalikan **tidak** diurutkan dalam urutan tertentu, jadi
pengurutan manual (misalnya menggunakan `Library.table.sort()`) sangat dianjurkan untuk
mengurutkan keturunan yang dikembalikan oleh metode ini. Juga pertimbangkan
 metode `Class.Instance:QueryDescendants()|QueryDescendants()` untuk melakukan
query keturunan berdasarkan kombinasi selector dan kombinator.

Instance:GetDescendants

Sebuah array yang berisi keturunan instance.

Mengembalikan array yang berisi semua keturunan dari instance.

Contoh kode ini menunjukkan perilaku dari `Class.Instance:GetFullName()`.
Ini menunjukkan bagaimana fungsi berperilaku saat dipanggil pada objek yang tidak berada di
hierarki `DataModel`, dan juga menunjukkan bagaimana nilai yang dikembalikan tidak meloloskan
karakter khusus.

Contoh kode ini mengimplementasikan kembali fungsi `Class.Instance:GetFullName()` dalam
Lua.

Mengembalikan string yang menjelaskan silsilah instance. String tersebut adalah
konkatenasi dari `Class.Instance.Name|Name` dari objek dan para nenek moyangnya,
yang dipisahkan oleh titik. `Class.DataModel` (`game`) tidak dianggap.
Sebagai contoh, sebuah `Class.Part` di dalam `Class.Workspace` mungkin
mengembalikan `Class.Workspace.Part`.

Ketika dipanggil pada `Class.Instance` yang bukan keturunan dari
`Class.DataModel`, metode ini mempertimbangkan semua nenek moyang hingga dan termasuk
nenek moyang teratas yang tidak memiliki `Class.Instance.Parent|Parent`.

Metode ini berguna untuk pencatatan dan debugging. Anda tidak seharusnya mencoba
mengurai string yang dikembalikan untuk operasi yang berguna; metode ini tidak
melindungi titik (atau simbol lainnya) dalam nama objek. Dengan kata lain,
meskipun outputnya sering tampak sebagai identifier Luau yang valid, itu tidak
dijamin.

Instance:GetFullName

Mengembalikan string yang menjelaskan silsilah instance.

Metode ini mengembalikan nilai yang telah ditata atau diubah secara eksplisit dari
properti yang ditentukan, atau nilai properti default jika belum diubah. Ini sedikit berbeda dari mengakses nilai properti secara langsung,
seperti `[GuiObject].Rotation`, yang mengembalikan nilai default atau
nilai yang dimodifikasi dari 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 yang diubah berdasarkan aturan)
print(button.Rotation) --> 0 (nilai default)

-- Ubah/modifikasi secara eksplisit properti yang ditata
button.Rotation = 45

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

Instance:GetStyled

selector

Selector opsional untuk instance pseudo yang Anda targetkan di
instance.

Nilai yang telah ditata atau diubah secara eksplisit dari
properti yang ditentukan, atau nilai properti default jika belum diubah.

Mengembalikan nilai yang telah ditata atau diubah secara eksplisit dari
 properti yang ditentukan, atau nilai properti defaultnya jika belum diubah.

Metode ini mengembalikan event yang berfungsi sama dengan event
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`,
 kecuali bahwa event ini hanya terpicu ketika properti gaya yang diberikan berubah. Ini
umumnya merupakan ide yang baik untuk menggunakan metode ini sebagai ganti 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 event yang sama.

Perlu dicatat bahwa event ini tidak akan melewatkan argumen ke fungsi yang menyambung,
jadi nilai dari 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("Properti gaya telah diubah!")
end

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

Instance:GetStyledPropertyChangedSignal

property

Nama dari properti gaya yang akan didengarkan untuk perubahan.

Event yang terpicu ketika properti gaya yang diberikan berubah.

Metode ini mengembalikan sebuah array dari tag yang diterapkan pada
diberikan instance, sebagai string. Anda dapat menambahkan tag baik di Studio
dalam jendela [Properties](/studio/properties) atau pada saat runtime
menggunakan `Class.Instance:AddTag()|AddTag()`.

Metode ini berguna ketika Anda ingin melakukan sesuatu dengan banyak tag dalam
sebuah instance sekaligus. Namun, tidak efisien menggunakan metode ini untuk
memeriksa keberadaan satu tag tertentu; sebagai gantinya, gunakan
`Class.Instance:HasTag()|HasTag()` untuk memeriksa tag tertentu.

Instance:GetTags

Mendapatkan array dari semua tag yang diterapkan pada instance.

Metode ini mengembalikan `true` jika tag yang diberikan telah ditambahkan ke
objek. Anda dapat menambahkan tag baik di Studio dalam jendela
[Properties](/studio/properties) atau pada saat runtime
dengan menggunakan `Class.Instance:AddTag()|AddTag()`.

Instance:HasTag

Memeriksa apakah instance memiliki tag yang diberikan.

Demonstrasikan penentuan apakah satu instance adalah nenek moyang dari yang lain menggunakan
`Class.Instance:IsAncestorOf()`

Workspace dan SpawnLocation adalah nenek moyang dari decal SpawnLocation.
Workspace adalah nenek moyang dari SpawnLocation.

SpawnLocation dan decal-nya adalah keturunan dari Workspace, bukan nenek moyang.
Decal adalah keturunan untuk SpawnLocation, bukan nenek moyang.


Mengembalikan true jika `Class.Instance` adalah nenek moyang dari keturunan yang
diberikan.

`Class.Instance` dianggap nenek moyang sebuah objek jika
`Class.Instance.Parent` objek tersebut atau salah satu `Class.Instance.Parent`
dari orangtuanya diatur ke `Class.Instance`.

Lihat juga, `Class.Instance:IsDescendantOf()`.

Instance:IsAncestorOf

Benar jika `Class.Instance` adalah nenek moyang dari keturunan yang diberikan.

Mengembalikan true jika `Class.Instance` adalah nenek moyang dari keturunan yang
diberikan.

Mengembalikan `true` jika `Class.Instance` adalah keturunan dari nenek moyang yang diberikan.

Perhatikan bahwa `IsDescendantOf()` tidak dapat digunakan dengan parameter `nil` untuk
memeriksa apakah sebuah objek telah dihapus.

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

Instance:IsDescendantOf

ancestor

Benar jika `Class.Instance` adalah keturunan dari nenek moyang yang diberikan.

Mengembalikan `true` jika `Class.Instance` adalah keturunan dari nenek moyang yang diberikan.

Instance:isDescendantOf

Metode ini menunjukkan apakah properti tertentu telah dimodifikasi dari
default yang diinstansiasi oleh kode. Jika dipanggil pada sebuah instance yang baru dibuat
dari kode (`Datatype.Instance.new()`), metode ini akan mengembalikan `false`. Jika
 dipanggil pada objek yang baru saja dibuat melalui alur kerja Studio seperti
dalam jendela [Explorer](/studio/explorer), hasilnya dapat berbeda.

Sebagai contoh, men-query properti
`Class.TextLabel.BackgroundColor3|BackgroundColor3` dari
`Class.TextLabel` yang disisipkan melalui jendela [Explorer](/studio/explorer)
akan mengembalikan `true`, tetapi men-query properti yang sama dari `Class.TextLabel`
yang dibuat melalui `Datatype.Instance.new()` akan mengembalikan `false`, asalkan
 tidak ada perubahan lain yang dilakukan pada
`Class.TextLabel.BackgroundColor3|BackgroundColor3`.

Perlu dicatat bahwa metode ini hanya mengembalikan hasil yang berguna untuk layanan dan
instance yang dapat dibuat pengguna. Nilai kembalian untuk properti yang
 diisi sistem dari instance seperti `Class.PackageLink` adalah perilaku yang tidak terdefinisi.

Juga perhatikan bahwa jika metode ini mengembalikan `true`, styling **tidak**
akan mempengaruhi properti karena modifikasi properti secara eksplisit memiliki
prioritas atas styling. Untuk mengatur ulang properti ke default yang diinstansiasi oleh kode dan memungkinkan
styling padanya, gunakan
`Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`.

Instance:IsPropertyModified

Boolean yang menunjukkan apakah properti telah dimodifikasi dari
 default yang diinstansiasi kode.

Mengembalikan `true` jika nilai yang disimpan pada properti yang ditentukan tidak sama
dengan default yang diinstansiasi oleh kode.

Metode objek ini mengembalikan array yang berisi semua keturunan dari
objek yang cocok dengan string `selector` yang diberikan. `selector` dapat mencakup
beberapa pemilih dan kombinator untuk mencocokkan karakteristik seperti
nama kelas, nama instance, dan hubungan hierarki, serta nilai tertentu dari
properti dan atribut instance. Tata bahasa `selector`
mirip dengan yang digunakan di `Class.StyleRule`, dengan hanya sedikit
differences mengenai bagian tata bahasa yang didukung atau tidak.

#### Pemilih

- `ClassName` — Mencocokkan instance dari kelas yang ditentukan dalam hubungan
  `Class.Object:IsA()`.
- `.Tag` — Mencocokkan instance yang diberi tag dengan tag `Class.CollectionService`.
- `#Name` — Mencocokkan instance dari `Class.Instance.Name` yang spesifik.
- `[property = value]` — Mencocokkan instance yang memiliki
  properti yang ditentukan dan properti tersebut memiliki nilai yang ditentukan. Nilai boolean, angka, dan
  string didukung. Huruf, angka, `_`, dan `-` dapat digunakan
  tanpa menempatkan nilai dalam tanda kutip.
- `[$attribute]` — Mencocokkan instance yang memiliki
  [atribut](/studio/properties#instance-attributes) yang ditentukan.
- `[$attribute = value]` — Mencocokkan instance yang memiliki atribut yang ditentukan **dan** atribut tersebut memiliki nilai yang ditentukan. Batasan yang sama berlaku seperti untuk pemilih properti. Jika Anda ingin memeriksa
  ketidakhadiran atribut, jangan kueri sebagai `nil`; sebaliknya gunakan
  kelas pseudo `:not` seperti pada `:not([$attribute])`.

Pemilih juga dapat digabungkan. Misalnya,
`Model.Apple[$Variety = Fuji][$Flavor = 4]` akan mencocokkan instance yang merupakan
`Class.Model` yang diberi tag sebagai `Apple` dan yang memiliki atribut `Variety`
equal to `Fuji` serta atribut `Flavor` yang sama dengan `4`.

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

-- Dapatkan semua keturunan MeshPart
print(Workspace:QueryDescendants("MeshPart"))

-- Dapatkan semua keturunan yang diberi tag sebagai "Fruit"
print(Workspace:QueryDescendants(".Fruit"))

-- Dapatkan semua keturunan dengan nama "RedTree"
print(Workspace:QueryDescendants("#RedTree"))

-- Dapatkan semua keturunan dengan properti CanCollide diatur ke false
print(Workspace:QueryDescendants("[CanCollide = false]"))

-- Dapatkan semua keturunan dengan atribut "FuelCapacity" yang ditetapkan
print(Workspace:QueryDescendants("[$FuelCapacity]"))
-- Dapatkan semua keturunan dengan atribut "FuelCapacity" diatur ke 75
print(Workspace:QueryDescendants("[$FuelCapacity = 75]"))
```

#### Kombinator

Kombinator memungkinkan Anda mencampur pemilih dasar untuk mencocokkan hubungan
hierarki yang lebih dalam.

- `>` — Mencocokkan instance yang merupakan **anak langsung** dari filter
  sebelumnya.

- `>>` — Mencocokkan instance yang merupakan **keturunan** dari filter
  sebelumnya. Ini adalah filter pertama default, yang berarti `SpotLight.Red`
  sama dengan `>> SpotLight.Red`.

- `,` — Menentukan daftar beberapa pemilih independen untuk
  kueri keturunan. Hanya elemen yang cocok dengan filter yang dimasukkan ke dalam
  array yang dikembalikan; `nil` tidak akan disertakan untuk non-cocok dalam daftar kueri.

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

-- Dapatkan anak langsung dari Model yang diberi tag sebagai "SwordPart"
print(Workspace:QueryDescendants("Model > .SwordPart"))

-- Dapatkan anak langsung yang merupakan Part dan diberi tag sebagai "Apple"
print(Workspace:QueryDescendants("> Part.Apple"))

-- Dapatkan keturunan dari Model mana pun dengan atribut "OnFire" diatur ke true
print(Workspace:QueryDescendants("Model >> [$OnFire = true]"))

-- Dapatkan keturunan MeshPart yang diberi tag sebagai "SwordPart" ATAU dengan atribut "OnFire" diatur ke true
print(Workspace:QueryDescendants("MeshPart.SwordPart, MeshPart[$OnFire = true]"))
```

#### Pemilih kelas pseudo

- `:not(complex-selector-list)` — Memungkinkan pemilihan instance yang **tidak**
mencocokkan salah satu pemilih di dalamnya, secara efektif melakukan
  negasi pemilih. Karena ekspresi di dalamnya adalah daftar pemilih kompleks,
mungkin untuk memfilter berdasarkan beberapa kondisi.

- `:has(relative-selector-list)` — Memungkinkan pemilihan instance berdasarkan
  instance yang mereka miliki di dalamnya. Daftar pemilih dievaluasi
  relatif terhadap setiap instance.

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

-- Dapatkan semua keturunan yang BUKAN dari kelas SpotLight
print(Workspace:QueryDescendants(":not(SpotLight)"))
-- Dapatkan semua keturunan yang BUKAN dari kelas SpotLight ATAU PointLight
print(Workspace:QueryDescendants(":not(SpotLight, PointLight)"))
-- Dapatkan semua keturunan yang TIDAK memiliki atribut "OnFire"
print(Workspace:QueryDescendants(":not([$OnFire])"))
-- Dapatkan semua keturunan KECUALI anak dari Model yang diberi tag sebagai "SwordPart"
print(Workspace:QueryDescendants(":not(Model > .SwordPart)"))

-- Dapatkan keturunan yang mengandung instance Tool sebagai keturunannya sendiri
print(Workspace:QueryDescendants(":has(Tool)"))
-- Dapatkan keturunan MeshPart yang mengandung anak langsung yang diberi tag sebagai "SwordPart"
print(Workspace:QueryDescendants("MeshPart:has(> .SwordPart)"))

-- Dapatkan keturunan MeshPart dengan anak langsung YANG BUKAN dari kelas SurfaceAppearance atau Texture
print(Workspace:QueryDescendants("MeshPart:has(> :not(SurfaceAppearance, Texture))"))
```


Instance:QueryDescendants

String selector yang digunakan untuk menyaring elemen.

Sebuah array dari instance (kosong jika tidak ada yang cocok dengan selector).

Mengembalikan array yang berisi semua keturunan dari instance yang cocok dengan
string `selector`.


Kode berikut menunjukkan bagaimana suatu bagian dapat ditambahkan kembali ke DataModel setelah dihapus:

Metode ini mengatur `Class.Instance.Parent` objek menjadi `nil`, dan melakukan
hal yang sama untuk semua keturunannya.

Jika objek dirujuk sebelum dihapus, Anda masih bisa mengambil objek tersebut di
nanti hari.

Instance:Remove

Mengatur `Parent` objek menjadi `nil`, dan melakukan hal yang sama untuk semua keturunannya.

Instance:remove

Metode ini menghapus tag dari sebuah instance. Tidak akan mengeluarkan kesalahan jika
objek tidak memiliki tag. Menghapus tag dengan sukses akan memicu sinyal yang dibuat oleh
`Class.CollectionService:GetInstanceRemovedSignal()` dengan tag yang diberikan.

Perlu dicatat bahwa ketika memberi tag pada sebuah instance, umumnya beberapa sumber
daya digunakan untuk memberikan fungsionalitas 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 diperlukan untuk tag.

Instance:RemoveTag

Mengatur ulang properti ke nilai defaultnya. Sebagai contoh, memanggil
`ResetPropertyToDefault("Rotation")` pada `Class.TextLabel` setara dengan
mengatur `Class.TextLabel.Rotation|Rotation`-nya ke `0` (nilai default properti).
Metode ini dapat digunakan untuk memastikan styling akan mengesampingkan
nilai default properti ini.

Instance:ResetPropertyToDefault

Mengatur ulang properti ke nilai defaultnya.

Metode ini mengatur atribut dengan nama yang diberikan ke nilai yang diberikan. Jika
nilai yang diberikan adalah `nil`, atribut akan dihapus, karena `nil` akan
kembali secara default.

Sebagai contoh, potongan kode berikut mengatur atribut `InitialPosition`
dari instance ke `Datatype.Vector3|Vector3.new(0, 10, 0)`:

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

local part = Workspace.Part
part:SetAttribute("InitialPosition", Vector3.new(0, 10, 0))
```

#### Pembatasan

Persyaratan dan pembatasan penamaan:

- Nama hanya boleh menggunakan karakter alfanumerik.
  - Anda juga dapat menyertakan titik, tanda hubung, garis miring, dan garis bawah.
- Tidak ada spasi atau simbol unik (seperti @, ~, !) yang diizinkan.
- String harus 100 karakter atau kurang.
- Nama tidak boleh diawali dengan **RBX** kecuali pemanggil adalah
  skrip inti Roblox (dipersiapkan untuk Roblox).

Saat mencoba mengatur atribut ke tipe yang tidak didukung, kesalahan akan
 dilemparkan.

#### Lihat Juga

- `Class.Instance:GetAttribute()` yang mengembalikan nilai yang telah ditetapkan
  untuk nama atribut yang diberikan.
- `Class.Instance:GetAttributes()` yang mengembalikan kamus dari pasangan kunci-nilai
  untuk setiap atribut instance.

Instance:SetAttribute

value

Nilai untuk mengatur atribut yang ditentukan.

Mengatur atribut dengan nama yang diberikan ke nilai yang diberikan.

Kode berikut menunggu sebuah instansi bernama "Part" untuk ditambahkan ke
Workspace.

Mengembalikan anak dari `Class.Instance` dengan nama yang diberikan. Jika
anak tersebut tidak ada, akan menunggu thread saat ini sampai ada. Jika
parameter `timeOut` ditentukan, metode ini akan mengalami timeout setelah
jumlah detik yang ditentukan dan mengembalikan `nil`.

#### Penggunaan Utama

`Class.Instance:WaitForChild()|WaitForChild()` sangat penting saat
bekerja dengan kode yang dijalankan oleh client dalam `Class.LocalScript`. Mesin
Roblox tidak menjamin waktu atau urutan di mana objek direplikasi dari server ke
client. Selain itu, jika sebuah pengalaman memiliki `Class.Workspace.StreamingEnabled`
yang diatur ke true,
`Class.BasePart|BaseParts` yang berada jauh dari karakter pemain
mungkin tidak akan disiarkan ke client, yang berpotensi menyebabkan skrip
berhenti berfungsi saat mengindeks objek yang belum ada di client.

#### Catatan

- Metode ini tidak akan menunggu jika anak dengan nama yang diberikan ada
  saat panggilan dilakukan.
- `Class.Instance:FindFirstChild()` adalah alternatif yang lebih efisien
  terhadap `Class.Instance:WaitForChild()|WaitForChild()` untuk objek yang
  diasumsikan ada.
- Jika panggilan ke metode ini melebihi 5 detik tanpa mengembalikan, dan tidak ada
  parameter `timeOut` yang ditentukan, sebuah peringatan akan dicetak ke
  output bahwa thread mungkin akan menunggu tanpa henti.

Instance:WaitForChild

childName

Mengembalikan anak dari `Class.Instance` dengan nama yang diberikan. Jika
anak tersebut tidak ada, akan menunggu thread saat ini sampai ada.

Instance

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

/reference/engine/classes/TextChatMessage.yaml