Sebuah `Attachment` mendefinisikan titik dan orientasi terhadap orang tua `Class.BasePart` , `Class.Bone` , atau lainnya `Attachment` .Offset disimpan dalam properti `Class.Attachment.CFrame|CFrame`.Offset juga dapat ditetapkan melalui properti lain, seperti `Class.Attachment.WorldCFrame|WorldCFrame` .

  lampiran digunakan oleh beberapa jenis `Class.Constraint|Constraints` dan juga merupakan alternatif yang valid untuk `Class.BasePart` sebagai orangtua untuk objek seperti:

  *   `Class.ParticleEmitter|ParticleEmitters` yang akan memancarkan partikel dari posisi/orientasi khusus lampiran alih-alih batas `Class.BasePart`.
  *   Objek pemancar cahaya seperti `Class.PointLight` dan `Class.SpotLight` yang akan bersinar dari posisi/orientasi lampiran bukan dari pusat `Class.BasePart`.
  *   `Class.Sound` yang akan menggunakan posisi lampiran sebagai titik fokus suara, bukan pusat `Class.BasePart`.

Kembalikan nilai lampir `Class.Attachment.Axis|Axis` .

Attachment:GetAxis

Kembalikan daftar `Class.Constraint|Constraints` terhubung ke lampir.

Attachment:GetConstraints

Kembalikan nilai lampir `Class.Attachment.SecondaryAxis|SecondaryAxis` .

Attachment:GetSecondaryAxis

Mengatur nilai lampir `Class.Attachment.Axis|Axis`.

Attachment:SetAxis

axis

Mengatur nilai lampir `Class.Attachment.SecondaryAxis|SecondaryAxis`.

Attachment:SetSecondaryAxis

Attachment

Arah dari **X** sumbu lampir, yang diwakili sebagai unit `Datatype.Vector3`.

Attachment.Axis

Offset `Datatype.CFrame` dari lampiran.Perubahan pada properti ini akan tercermin pada properti `Class.Attachment.Position|Position` dan `Class.Attachment.Rotation|Rotation` dari objek ini.Demikian pula, perubahan pada salah satu properti tersebut akan tercermin pada properti ini.

Attachment.CFrame

Orientasi lampiran relatif terhadap orientasi orang tuanya. Rotasi ada di **Z** , **X** , **Y** urutan.

Attachment.Orientation

Orientasi lampiran terhadap orientasi orang tuanya.

Offset posisional dari lampiran, relatif terhadap posisi dan orientasi orang tuanya.

Attachment.Position

Rotasi lampiran relatif terhadap rotasi orang tuanya. Rotasi ada di **Z** , **Y** , **X** urutan.

Attachment.Rotation

Rotasi lampiran relatif terhadap rotasi orang tuanya.

Arah dari **Y** sumbu lampir, yang diwakili sebagai unit `Datatype.Vector3`.

Attachment.SecondaryAxis

Mengubah visibilitas dalam pengalaman lampiran.

Attachment.Visible

Arah dari **X** sumbu lampir terhadap dunia, yang diwakili sebagai unit `Datatype.Vector3` dengan panjang 1.

Attachment.WorldAxis

Persis `Datatype.CFrame` dari lampiran di koordinat ruang dunia, independen dari orang tuanya.Nilai properti ini setara dengan menggandakan `Datatype.CFrame` dari orang tua lampiran dengan sendiri `Datatype.CFrame` .

Attachment.WorldCFrame

Persis `Datatype.CFrame` dari lampiran di koordinat ruang dunia.

Orientasi lampiran terhadap dunia daripada orang tuanya sendiri. Rotasi berada di **Z** , **X** , **Y** urutan.

Attachment.WorldOrientation

Orientasi lampiran terhadap dunia daripada orang tuanya sendiri.

Posisi lampiran terhadap dunia daripada orang tuanya sendiri.

Attachment.WorldPosition

Rotasi lampiran terhadap dunia daripada orang tuanya sendiri.

Attachment.WorldRotation

Arah dari **Y** sumbu lampir terhadap dunia, yang diwakili sebagai unit `Datatype.Vector3` dengan panjang 1.

Attachment.WorldSecondaryAxis

Mendefinisikan titik dan orientasi relatif terhadap orang tua `Class.BasePart` , `Class.Bone` , atau lainnya `Class.Attachment` .

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

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

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

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

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

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

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

Instance.AncestryChanged

child

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

parent

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

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

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

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

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

  local part = Workspace.Part

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

  part.AttributeChanged:Connect(attributeChanged)
  ```

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

Instance.AttributeChanged

attribute

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

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

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

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

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

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

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

  Lihat juga `Class.Instance.ChildRemoved` .

Instance.ChildAdded

The `Class.Instance` yang telah ditambahkan.

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

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

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

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

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

  Lihat juga `Class.Instance.ChildAdded` .

Instance.ChildRemoved

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

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

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

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

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

  Lihat juga `Class.Instance.DescendantRemoving` .

Instance.DescendantAdded

descendant

Api setelah keturunan ditambahkan ke `Class.Instance` .

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

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

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

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

  ##### Peringatan

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

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

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

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

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

Instance.DescendantRemoving

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

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

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

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

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

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

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

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

Instance.Destroying

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

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

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

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

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

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

Instance.StyledPropertiesChanged

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

Instance.childAdded

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

  ##### Peringatan

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

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

Instance:AddTag

Fungsi ini menghancurkan semua anak dan keturunan instansi.

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

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

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

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

  part:ClearAllChildren()

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

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

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

  local model = Workspace:FindFirstChild("TestModel")

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

Instance:ClearAllChildren

Fungsi ini menghancurkan semua anak instansi.

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

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

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

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

Instance:Clone

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

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

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

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

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

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

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

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

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

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

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

Instance:Destroy

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

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

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

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

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

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

Instance:FindFirstAncestor

name

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

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

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

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

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

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

Instance:FindFirstAncestorOfClass

className

The `Class.Object.ClassName` untuk dicari.

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

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

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

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

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

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

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

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

Instance:FindFirstAncestorWhichIsA

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

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

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

  ##### Memeriksa Keberadaan Objek

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

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

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

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

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

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

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

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

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

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

  ##### Catatan Kinerja

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

Instance:FindFirstChild

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

recursive

Apakah pencarian harus dilakukan secara berulang atau tidak.

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

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

Instance:FindFirstChildOfClass

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

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

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

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

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

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

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

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

Instance:FindFirstChildWhichIsA

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

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

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

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

Instance:FindFirstDescendant

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

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

Instance:GetActor

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

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

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

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

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

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

  ##### Lihat Juga

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

Instance:GetAttribute

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

Kembalikan nilai yang telah ditugaskan ke nama atribut yang diberikan.

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

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

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

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

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

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

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

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

Instance:GetAttributeChangedSignal

Nama atribut yang ditentukan untuk mana sinyal perubahan dikembalikan.

Sebuah peristiwa yang menembak ketika atribut yang diberikan berubah.

Kembalikan acara yang terbakar saat atribut yang diberikan berubah.

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

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

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

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

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

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

Instance:GetAttributes

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

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

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

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

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

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

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

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

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

Instance:GetChildren

Sebuah array yang berisi anak-anak instansi.

Kembalikan array yang berisi semua anak instansi.

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

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

Instance:GetDebugId

scopeLength

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

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

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

Instance:GetDescendants

Sebuah array yang berisi keturunan instansi.

Kembalikan array yang berisi semua keturunan instansi.

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

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

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

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

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

Instance:GetFullName

Kembalikan string yang menjelaskan leluhur instansi.

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

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

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

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

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

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

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

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

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

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

Instance:GetStyled

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

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

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

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

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

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

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

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

Instance:GetStyledPropertyChangedSignal

property

Nama properti gaya untuk mendengarkan perubahan.

Peristiwa yang menembak ketika properti gaya yang diberikan berubah.

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

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

Instance:GetTags

Mendapatkan array dari semua tag yang diterapkan ke instansi.

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

Instance:HasTag

Periksa apakah instansi memiliki tag yang diberikan.

Demonstrates determining if one instance is the ancestor of another using `Class.Instance:IsAncestorOf()`

Workspace and SpawnLocation are ancestors of the SpawnLocation's decal.
Workspace is an ancestor of SpawnLocation.

SpawnLocation and its decal are descendants of Workspace, not ancenstors.
Decal is a descendant to SpawnLocation, not an ancestor.

Kembalikan benar jika `Class.Instance` adalah leluhur dari keturunan yang diberikan.

  Sebuah `Class.Instance` dianggap sebagai leluhur dari objek jika objeknya `Class.Instance.Parent` atau salah satu dari orangtuanya `Class.Instance.Parent` diatur ke `Class.Instance`.

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

Instance:IsAncestorOf

Benar jika `Class.Instance` adalah leluhur dari keturunan yang diberikan.

Kembalikan benar jika `Class.Instance` adalah leluhur dari keturunan yang diberikan.

Kembalikan `true` jika `Class.Instance` adalah keturunan dari leluhur yang diberikan.

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

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

Instance:IsDescendantOf

ancestor

Benar jika `Class.Instance` adalah keturunan dari leluhur yang diberikan.

Kembalikan `true` jika `Class.Instance` adalah keturunan dari leluhur yang diberikan.

Kembalikan `true` jika nilai yang disimpan dalam properti yang ditentukan sama dengan kode yang diinstanisasi default. Misalnya, jika mengekspor properti `Class.TextLabel.TextSize|TextSize` dari `Class.TextLabel` menunjukkan `8` , maka memanggil `IsPropertyModified("TextSize")` pada label akan mengembalikan `false` karena `8` adalah nilai default untuk `Class.TextLabel.TextSize` ketika label dibuat melalui `Instance.new("TextLabel")` alih-alih dimasukkan melalui alur pekerjaan penyisipan Studio.

  Perhatikan bahwa jika metode ini mengembalikan , penataan tidak akan mempengaruhi properti karena secara eksplisit memodifikasi properti lebih berprioritas daripada menatahkannya.

Instance:IsPropertyModified

Boolean menunjukkan apakah properti dimodifikasi.

Kembalikan `true` jika nilai yang disimpan dalam properti yang ditentukan sama dengan kode yang diinstanisasi default.

The following code demonstrates how a part can be re-added to the DataModel
after being removed:

Fungsi ini menetapkan `Class.Instance.Parent` objek menjadi `nil` , dan melakukan hal yang sama untuk semua keturunannnya.

  Jika objek di referensikan sebelum dihapus, mungkin untuk mengambil kembali objek pada titik kemudian.

Instance:Remove

Atur objek `Parent` ke `nil` , dan lakukan hal yang sama untuk semua keturunannya.

Metode ini menghapus tag dari instansi.Ini tidak akan menyebabkan kesalahan jika objek tidak memiliki tag.Berhasil menghapus tag akan menyala sinyal yang dibuat oleh `Class.CollectionService:GetInstanceRemovedSignal()` dengan tag yang diberikan.

  Perhatikan bahwa ketika menandai instansi, umumnya beberapa sumber daya digunakan untuk memberikan tag fungsionalitasnya, misalnya koneksi acara atau tabel.Untuk mencegah kebocoran memori, ide bagus adalah membersihkan ini (putus koneksi, atur ke `nil` , dll.) ketika tidak lagi dibutuhkan untuk tag.

Instance:RemoveTag

Mengatur ulang properti ke nilai defaultnya.Sebagai contoh, memanggil `ResetPropertyToDefault("Rotation")` pada `Class.TextLabel` adalah sama dengan mengatur `Class.TextLabel.Rotation|Rotation` ke `0` (nilai default properti).Metode ini dapat digunakan untuk memastikan desain akan menggantikan nilai default dari properti ini.

Instance:ResetPropertyToDefault

Mengatur ulang properti ke nilai defaultnya.

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

  Sebagai contoh, potongan kode berikut menetapkan atribut instance `InitialPosition` 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))
  ```

  ##### Keterbatasan

  Persyaratan dan batasan penamaan:

  *   Nama hanya boleh menggunakan karakter alfanumerik dan dasbor.
  *   Tidak ada ruang atau simbol unik yang diizinkan.
  *   String harus 100 karakter atau kurang.
  *   Nama tidak diperbolehkan untuk dimulai dengan **RBX** kecuali panggilan adalah skrip inti Roblox (ditahan untuk Roblox).

  Saat mencoba untuk mengatur atribut ke jenis yang tidak didukung, kesalahan akan terjadi.

  ##### Lihat Juga

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

Instance:SetAttribute

value

Nilai untuk mengatur atribut yang ditentukan ke.

Atur atribut dengan nama yang diberikan ke nilai 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/Attachment.yaml

Attachment

Rangkuman

Properti

Metode

Acara

Properti

Metode

Acara