ตัวอย่างโค้ดนี้ประกอบด้วยฟังก์ชันง่ายๆ ในการสร้าง `Class.Animation` พร้อมกับ
รหัสแฮชที่สร้างขึ้นเพื่อดูตัวอย่าง `Class.KeyframeSequence` ในเครื่องท้องถิ่น.

บริการ **KeyframeSequenceProvider** ให้ฟังก์ชันในการโหลดและ
ดูตัวอย่าง `Class.KeyframeSequence|KeyframeSequences` ประกอบด้วยฟังก์ชันหลายอย่างที่มีประโยชน์เมื่อทำงานกับ `Class.Animation|Animations`。

`Class.KeyframeSequence` จะเก็บซีรีส์ของ `Class.Pose|Poses` ที่เข้ารหัส
ลำดับชั้นและการเคลื่อนไหวของการเคลื่อนไหว ข้อมูลการเคลื่อนไหวที่ Roblox ใช้ในการเล่นการเคลื่อนไหว อ้างอิงจากคุณสมบัติ `Class.Animation.AnimationId`
สามารถสร้างจาก `Class.KeyframeSequence`。
`Class.KeyframeSequence|KeyframeSequences` มักจะถูกสร้างขึ้นโดย Roblox
[Animation Editor](/animation/editor) แต่สามารถสร้างผ่าน
ปลั๊กอินอื่นหรือแม้กระทั่งด้วยตนเอง。


ตัวอย่างโค้ดนี้รวมถึงการสาธิตวิธีการดาวน์โหลด ID ของเนื้อหาของแอนิเมชัน
ที่เป็นของผู้เล่นโดยใช้
`Class.KeyframeSequenceProvider:GetAnimations()`. เพื่อเรียกใช้โค้ดนี้โปรดแน่ใจว่า
ได้เปลี่ยนตัวแปร _USER_ID_ เป็น ID ของผู้ใช้ที่คุณต้องการ
ดาวน์โหลดแอนิเมชัน.

ฟังก์ชันนี้คืนค่ากลับเป็นออบเจ็กต์ `Class.InventoryPages` ซึ่งสามารถใช้
เพื่อวนซ้ำผ่านการเคลื่อนไหวที่ผู้ใช้เฉพาะเป็นเจ้าของ。

ฟังก์ชันนี้มีการใช้งานที่เป็นไปได้หลายอย่าง เช่น อนุญาตให้ผู้ใช้
เรียกดูและนำเข้าการเคลื่อนไหวไปยังปลั๊กอินการเคลื่อนไหวที่กำหนดเอง。


KeyframeSequenceProvider:GetAnimations

userId

รหัสผู้ใช้ของผู้ใช้。


ออบเจ็กต์ `Class.InventoryPages` ของการเคลื่อนไหว。


ฟังก์ชันนี้คืนค่ากลับเป็นออบเจ็กต์ `Class.InventoryPages` ซึ่งสามารถใช้
เพื่อวนซ้ำผ่านการเคลื่อนไหวที่ผู้ใช้เฉพาะเป็นเจ้าของ。


คืนค่ากลับเป็น `Class.KeyframeSequence` จาก URL ของทรัพย์สินที่กำหนด。


KeyframeSequenceProvider:GetKeyframeSequence

assetId

รหัสเนื้อหาของการเคลื่อนไหว。


`Class.KeyframeSequence` ที่พบ。


สาธิตการสร้าง KeyframeSequence ของการแอนิเมชันโดยใช้ `Class.KeyframeSequenceProvider:GetKeyframeSequenceAsync()` และพิมพ์เวลาของแต่ละ keyframe.

GetKeyframeSequenceAsync คืนค่า `Class.KeyframeSequence` ตาม
assetId ที่ระบุ assetId ต้องสอดคล้องกับการเคลื่อนไหว ฟังก์ชันจะรอจนกว่า `Class.KeyframeSequence` จะถูกโหลดจาก
เว็บไซต์ เนื่องจากนี่เป็นการเรียกใช้งานทางเว็บจึงควรหุ้มด้วย pcall。


KeyframeSequenceProvider:GetKeyframeSequenceAsync

คืนค่า KeyframeSequence ตาม assetId ที่ระบุแบบอะซิงโครนัส。


คืนค่า `Class.KeyframeSequence` จาก assetId ที่จัดหา สามารถ
เลือกใช้ในการแคชเพื่อลดการโหลดหยุดนิ่งที่ไม่จำเป็น。


KeyframeSequenceProvider:GetKeyframeSequenceById

useCache

True ถ้าสามารถคืนเวอร์ชันที่แคชได้。


คืนค่า `Class.KeyframeSequence` จาก assetId ที่จัดหา。


สร้างรหัสทรัพย์สินชั่วคราวจาก `Class.KeyframeSequence` ที่สามารถ
ใช้สำหรับการทดสอบการเคลื่อนไหวในพื้นที่。

ฟังก์ชันนี้ทำหน้าที่เดียวกันกับ `Class.KeyframeSequenceProvider:RegisterKeyframeSequence()` แต่ฟังก์ชันนี้
สร้าง URL แบบ _active://_ แทนการสร้างแฮช。

รหัสที่สร้างขึ้นสามารถใช้ในคุณสมบัติ `Class.Animation.AnimationId`
สำหรับการทดสอบ。

รหัสทรัพย์สินที่สร้างขึ้นจากฟังก์ชันนี้เป็นชั่วคราวและไม่สามารถใช้
นอก Studio ได้ นักพัฒนาที่ต้องการสร้างรหัสทรัพย์สินที่ใช้ได้
ออนไลน์ควรอัปโหลด `Class.KeyframeSequence` ไปยัง Roblox。


KeyframeSequenceProvider:RegisterActiveKeyframeSequence

keyframeSequence

`Class.KeyframeSequence` ที่จะใช้。


รหัสทรัพย์สินชั่วคราวที่สร้างขึ้นสำหรับการเล่นการเคลื่อนไหวในพื้นที่。


สร้างรหัสทรัพย์สินชั่วคราวจาก `Class.KeyframeSequence` ที่สามารถ
ใช้สำหรับการทดสอบการเคลื่อนไหวในพื้นที่ สร้าง URL แบบ _active://_。


สร้างรหัสทรัพย์สินชั่วคราวจาก `Class.KeyframeSequence` ที่สามารถ
ใช้สำหรับการทดสอบการเคลื่อนไหวในพื้นที่。

ฟังก์ชันนี้ทำหน้าที่เดียวกันกับ `Class.KeyframeSequenceProvider:RegisterActiveKeyframeSequence()` แต่ฟังก์ชันนี้
สร้างแฮชแทนที่จะเป็น URL แบบ _active://_。

รหัสที่สร้างขึ้นสามารถใช้สำหรับคุณสมบัติ `Class.Animation.AnimationId`
ในการทดสอบการเคลื่อนไหว。

รหัสทรัพย์สินที่สร้างขึ้นจากฟังก์ชันนี้เป็นชั่วคราวและไม่สามารถใช้
นอก Studio ได้ นักพัฒนาที่ต้องการสร้างรหัสทรัพย์สินที่ใช้ได้
ออนไลน์ควรอัปโหลด `Class.KeyframeSequence` ไปยัง Roblox。


KeyframeSequenceProvider:RegisterKeyframeSequence

สร้างรหัสทรัพย์สินชั่วคราวจาก `Class.KeyframeSequence` ที่สามารถ
ใช้สำหรับการทดสอบการเคลื่อนไหวในพื้นที่ สร้างแฮช。


KeyframeSequenceProvider

ให้ฟังก์ชันในการโหลดและดูตัวอย่าง `Class.KeyframeSequence`。


`Instance` เป็นคลาสพื้นฐานสำหรับคลาสทั้งหมดในลำดับชั้นคลาส Roblox
ซึ่งสามารถเป็นส่วนหนึ่งของต้นไม้ `Class.DataModel`。

ไม่สามารถสร้างวัตถุ `Instance` รากได้โดยตรง แต่เมื่อใช้
ตัวสร้าง `Datatype.Instance.new()` จะสร้างวัตถุผ่านทางโค้ด โดยรับ
ชื่อของคลาสเป็นพารามิเตอร์และส่งคืนวัตถุที่สร้างขึ้น。


แสดงให้เห็นถึงการตรวจสอบการเปลี่ยนแปลงในประวัติของอินสแตนซ์โดยเชื่อมต่อกับเหตุการณ์ `Class.Instance.AncestryChanged`.

พาร์ต ChangingPart ถูกตั้งค่าเป็นค่าที่แตกต่างกันเมื่อเวลา ผ่านไป แพเรนต์ของพาร์ตคือบรรพบุรุษของพาร์ต ดังนั้นเหตุการณ์ `Class.Instance.AncestryChanged` จะถูกเรียกใช้เมื่อมันเปลี่ยนแปลง.

เกิดขึ้นเมื่อเปลี่ยนแปลงคุณสมบัติ `Class.Instance.Parent` ของวัตถุหรือ
บรรพบุรุษของมัน.

เหตุการณ์นี้รวมถึงพารามิเตอร์สองตัว: `child` อ้างถึง `Class.Instance`
ที่ `Class.Instance.Parent` ถูกเปลี่ยนแปลง ในขณะที่ `parent` หมายถึง
`Class.Instance.Parent` ใหม่ของอินสแตนซ์นี้.

คุณสามารถใช้เหตุการณ์นี้เพื่อติดตามการลบอินสแตนซ์ใน Studio,
เช่น การลบบันทึกด้วยตนเองใน Explorer หรือผ่านปลั๊กอิน หากคุณต้องการ
ตรวจจับเมื่ออินสแตนซ์ถูกทำลายโดยใช้ `Class.Instance:Destroy()`,
ให้ใช้เหตุการณ์ `Class.Instance.Destroying` แทน.


Instance.AncestryChanged

child

`Class.Instance` ที่ `Class.Instance.Parent` ได้ถูกเปลี่ยนแปลง.


parent

`Class.Instance.Parent` ใหม่ของ `Class.Instance` ที่
`Class.Instance.Parent` ได้ถูกเปลี่ยนแปลง.


เกิดขึ้นเมื่อเปลี่ยนแปลงคุณสมบัติ `Class.Instance.Parent` ของวัตถุหรือ
บรรพบุรุษของมัน.


เหตุการณ์นี้เกิดขึ้นเมื่อมีการเปลี่ยนแปลงแอตทริบิวต์ใด ๆ บนอินสแตนซ์,
รวมถึงเมื่อมีการตั้งค่าแอตทริบิวต์เป็น `nil` ชื่อของแอตทริบิวต์ที่เปลี่ยนแปลง
จะถูกส่งให้กับฟังก์ชันที่เชื่อมโยง.

ตัวอย่างเช่น โค้ดด้านล่างเชื่อมต่อฟังก์ชัน `attributeChanged()`
เพื่อให้ทำงานเมื่อมีการเปลี่ยนแปลงแอตทริบิวต์ของส่วนใดส่วนหนึ่ง:

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

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "เปลี่ยนแปลง")
end

part.AttributeChanged:Connect(attributeChanged)
```
ดูเพิ่มเติมได้ที่ `Class.Instance:GetAttributeChangedSignal()` ซึ่งจะส่งคืนเหตุการณ์ที่
เกิดขึ้นเมื่อแอตทริบิวต์ที่กำหนดมีการเปลี่ยนแปลง.


Instance.AttributeChanged

attribute

ชื่อของแอตทริบิวต์ที่ถูกเปลี่ยนแปลง.


เกิดขึ้นเมื่อมีการเปลี่ยนแปลงใด ๆ ของแอตทริบิวต์ที่อยู่บน `Class.Instance`.


โค้ดนี้จะแสดงชื่อของวัตถุเมื่อถูกเพิ่มเข้าไปใน Workspace:

เกิดขึ้นหลังจากที่วัตถุถูกเป็นพ่อแม่ให้กับ `Class.Instance` นี้.

โปรดทราบ เมื่อใช้ฟังก์ชันนี้บนไคลเอนต์เพื่อตรวจจับวัตถุที่สร้างโดย
เซิร์ฟเวอร์จะต้องใช้ `Class.Instance:WaitForChild()` เมื่อทำการดัชนีของบุตรนั้น.
เป็นเพราะว่าวัตถุและทายาทของมันไม่ได้รับประกันว่าจะทำการทำซ้ำจากเซิร์ฟเวอร์
ไปยังไคลเอนต์ในเวลาเดียวกัน ตัวอย่างเช่น:

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

Workspace.ChildAdded:Connect(function(child)
	-- ใช้ WaitForChild() เพราะทายาทอาจยังไม่ทำซ้ำ
	local head = child:WaitForChild("Head")
end)
```
โปรดทราบ ฟังก์ชันนี้ใช้งานเฉพาะสำหรับบุตรที่อยู่ทันทีของ
`Class.Instance`. สำหรับฟังก์ชันที่จับทุกรุ่นที่เป็นทายาทให้ใช้
`Class.Instance.DescendantAdded`.

ดูเพิ่มเติมได้ที่ `Class.Instance.ChildRemoved`.


Instance.ChildAdded

`Class.Instance` ที่ถูกเพิ่ม.


เกิดขึ้นหลังจากที่วัตถุถูกเป็นพ่อแม่ให้กับ `Class.Instance` นี้.


สคริปต์นี้จะแสดงชื่อของวัตถุเมื่อถูกลบออกจาก
Workspace:

เกิดขึ้นหลังจากที่เด็กถูกลบออกจาก `Class.Instance` นี้.

ลบออกหมายถึงเมื่อพ่อแม่ของวัตถุถูกเปลี่ยนจาก `Class.Instance`
เป็นบางอย่างที่ไม่ใช่ `Class.Instance` นี้ โปรดทราบว่าเหตุการณ์นี้
จะเกิดขึ้นเมื่อเด็กถูกทำลาย (`Class.Instance:Destroy()`) เนื่องจากวิธีการทำลายจะตั้งค่าพ่อแม่ของวัตถุ
เป็น `nil`.

ฟังก์ชันนี้ทำงานเฉพาะสำหรับบุตรที่อยู่ทันทีของ `Class.Instance`.
สำหรับฟังก์ชันที่จับทุกรุ่นที่เป็นทายาทให้ใช้
`Class.Instance.DescendantRemoving`.

ดูเพิ่มเติมได้ที่ `Class.Instance.ChildAdded`.


Instance.ChildRemoved

`Class.Instance` ที่ถูกลบ.


เกิดขึ้นหลังจากที่เด็กถูกลบออกจาก `Class.Instance` นี้.


ตัวอย่างต่อไปนี้จะแสดงชื่อของวัตถุใดๆ ที่ถูกเพิ่มเข้าไปใน
Workspace:

เหตุการณ์นี้เกิดขึ้นหลังจากที่บุตรของ `Class.Instance` ถูกเพิ่ม.

เนื่องจากเหตุการณ์นี้เกิดขึ้นสำหรับบุตรทุกคน,
การตั้งค่าวัตถุให้กับ `Class.Instance` จะเกิดเหตุการณ์นี้สำหรับวัตถุ
นี้และทายาททั้งหมดของมันโดยเฉพาะ.

หากคุณสนใจเฉพาะ **เด็กที่ตรง** ของ `Class.Instance`, ให้ใช้
`Class.Instance.ChildAdded` แทน.

ดูเพิ่มเติมได้ที่ `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

descendant

เกิดขึ้นหลังจากที่บุตรของ `Class.Instance` ถูกเพิ่ม.


ตัวอย่างต่อไปนี้แสดงผลชื่อของสิ่งที่ถูกลูกหลานเมื่อมันถูกลบออก
จาก Workspace:

เหตุการณ์นี้เกิดขึ้น **ก่อนทันที** ที่พ่อแม่ `Class.Instance`
เปลี่ยนแปลงจนนำไปสู่การที่อินสแตนซ์ **ทายาท** จะไม่เป็นทายาทอีกต่อไป.
`Class.Instance:Destroy()|Destroy()` เปลี่ยน `Class.Instance.Parent|Parent` ของอินสแตนซ์เป็น `nil`, ดังนั้นการเรียกใช้วิธีนั้นบนทายาทของต้นจะทำให้เหตุการณ์นี้เกิดขึ้น.

เหตุการณ์นี้เกิดขึ้น **ก่อน** การลบของทายาท,
ดังนั้นพ่อแม่ของทายาทจะไม่เปลี่ยนในขณะที่เหตุการณ์นี้เกิดขึ้น หากทายาท
ก็เป็น **เด็กโดยตรง** ของต้น เหตุการณ์นี้จะเกิดขึ้น
ก่อน `Class.Instance.ChildRemoved`.

หากทายาทมีบุตร, เหตุการณ์นี้จะเกิดขึ้นกับทายาทก่อน,
ตามด้วยทายาท.

##### คำเตือน

เหตุการณ์นี้จะเกิดขึ้นด้วยวัตถุทายาทที่กำลังจะถูกลบ.
การพยายามตั้งค่า `Class.Instance.Parent|Parent` ของทายาทให้เป็นสิ่งอื่นจะล้มเหลว ตัวอย่างด้านล่างแสดงให้เห็น:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- อย่าลงมือจัดการพ่อแม่ของทายาทในฟังก์ชันนี้!
	-- เหตุการณ์นี้เกิดขึ้นเพราะพ่อแม่ถูกจัดการ, และการเปลี่ยนแปลงยังไม่เกิดขึ้น
	-- ดังนั้นการเปลี่ยนแปลงพ่อแม่จึงมีปัญหา:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
ดูเพิ่มเติมได้ที่ `Class.Instance.DescendantAdded|DescendantAdded`.


Instance.DescendantRemoving

`Class.Instance` ที่กำลังถูกลบออก.


เกิดขึ้นทันทีเมื่อลูกหลานของ `Class.Instance` ถูกลบออก.


ตัวอย่างนี้แสดงให้เห็นว่า เมื่อใช้พฤติกรรมสัญญาณทันที อินสแตนซ์ที่ถูกทำลายจะยังคงอยู่ในที่นั้นจนกว่าฟังก์ชันที่เชื่อมต่อจะหยุดทำงาน.

ตัวอย่างนี้แสดงให้เห็นว่าเมื่อใช้พฤติกรรมสัญญาณที่ล่าช้า
อินสแตนซ์จะถูกทำลายก่อนที่สัญญาณจะถูกเรียก

`Class.Instance` จะไม่ถูกลบออกจากหน่วยความจำในขณะที่ฟังก์ชันที่เชื่อมโยงยังคงใช้งานอยู่.
แต่หากฟังก์ชันนั้นหยุดชะงักในขณะใด,
`Class.Instance` และทายาทของมันจะถูกตั้งค่าให้ `nil`.

หากคุณสมบัติ `Class.Workspace.SignalBehavior` ถูกตั้งค่าเป็น
`Enum.SignalBehavior.Immediate`, เหตุการณ์นี้จะเกิดขึ้นก่อนทันทีที่
`Class.Instance` หรือหนึ่งในบรรพบุรุษของมันถูกทำลายด้วย
`Class.Instance:Destroy()`.

หากคุณสมบัติ `Class.Workspace.SignalBehavior` ถูกตั้งค่าเป็น
`Enum.SignalBehavior.Deferred`, เหตุการณ์นี้จะเกิดขึ้นที่จุดที่กลับคืน ถัดไป,
ซึ่งจะเกิดขึ้นหลังจากที่ `Class.Instance` หรือหนึ่งในบรรพบุรุษของมันถูกทำลายด้วย
`Class.Instance:Destroy()`.

ด้วยพฤติกรรม `Enum.SignalBehavior.Deferred|Deferred`, การเชื่อมต่อสคริปต์กับ
เหตุการณ์ `Class.Instance.Destroying` ของตัวมันเองอาจมีปัญหา เนื่องจากสคริปต์
จะถูกทำลายก่อนที่การเรียกกลับจะสามารถถูกเรียก (ซึ่งหมายความว่าฟังก์ชันนั้นจะไม่ถูกเรียกใช้).

เมื่อทำลาย `Class.Instance` ใน Studio, เช่น การลบด้วยตนเอง
ผ่านทาง [Explorer](/studio/explorer) หรือผ่านปลั๊กอิน,
`Class.Instance` จะไม่ถูกทำลาย แทนที่จะตั้งค่า `Parent` ให้เป็น `nil`
ซึ่งคุณสามารถติดตามได้ด้วย `Class.Instance.AncestryChanged`.


Instance.Destroying

เกิดขึ้นทันที ก่อน (หรือเลื่อนจนถึงหลัง) ที่อินสแตนซ์ถูกทำลายโดย `Class.Instance:Destroy()`.


เหตุการณ์นี้จะเกิดขึ้นเมื่อมีการเปลี่ยนแปลงใด ๆ ของคุณสมบัติรูปแบบในอินสแตนซ์,
รวมถึงเมื่อคุณสมบัติถูกตั้งค่าเป็น `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("คุณสมบัติรูปแบบถูกเปลี่ยนแปลง")
end

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


Instance.StyledPropertiesChanged

เกิดขึ้นเมื่อค่าใด ๆ ของคุณสมบัติรูปแบบได้ถูกเปลี่ยนแปลงในอินสแตนซ์,
รวมถึงเมื่อคุณสมบัติถูกตั้งค่าเป็น `nil`.


Instance.childAdded

วิธีนี้ใช้แท็กกับวัตถุ ไม่มีผลถ้าหากแท็กถูกใช้แล้ว การเพิ่มแท็ก
ให้สำเร็จจะส่งสัญญาณที่สร้างโดย
`Class.CollectionService:GetInstanceAddedSignal()` โดยมีแท็กที่กำหนด。

##### คำเตือน

- แท็กของวัตถุที่เพิ่มจากฝั่งผู้ใช้จะถูกละทิ้งหากเซิร์ฟเวอร์เพิ่มหรือ\้นำแท็กออกจากวัตถุนั้นในภายหลัง เพราะเซิร์ฟเวอร์จะทำซ้ำแท็กทั้งหมด
ด้วยกันและเขียนทับแท็กก่อนหน้านี้ได้。

- เมื่อแท็กวัตถุทั่วไป ควรคำนึงถึงว่าทรัพยากรบางส่วนจะถูกใช้
เพื่อให้แท็กทำงาน เช่นการเชื่อมต่อเหตุการณ์หรือข้อมูล
table เพื่อลดปัญหการใช้หน่วยความจำ ควรสะสางให้เรียบร้อย (ตัดการเชื่อมต่อ
ตั้งค่าเป็น `nil` เป็นต้น) เมื่อไม่จำเป็นต้องใช้งานในแท็ก ทำแบบนี้เมื่อ
เรียกใช้ `Class.Instance:RemoveTag()` หรือ
เมื่อเรียกใช้ `Class.Instance:Destroy()` หรือในฟังก์ชันที่เชื่อมต่อกับ
สัญญาณที่ส่งคืนโดย `Class.CollectionService:GetInstanceRemovedSignal()`。


Instance:AddTag

ใช้แท็กกับวัตถุ。


ฟังก์ชันนี้ทำลายลูกหลานทั้งหมดของอินสแตนซ์และลูกหลาน。

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

-- เพิ่มประกายไฟ
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
```
หากคุณไม่ต้องการทำลาย **ลูกหลาน** และลูกหลานทั้งหมด ใช้
`Class.Instance:GetChildren()` หรือ `Class.Instance:GetDescendants()` ในการ
วนซ้ำผ่านลูกหลานเหล่านั้นและเลือกที่จะทำลาย สำหรับตัวอย่างโค้ดต่อไปนี้
จะทำลาย `Class.BasePart|BaseParts` ที่แสดงจาก `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

ฟังก์ชันนี้ทำลายลูกหลานทั้งหมดของอินสแตนซ์。


แสดงการโคลนโมเดลโดยใช้ `Class.Instance:Clone()`.

`Clone()` สร้างสำเนาของวัตถุและลูกหลานทั้งหมด
โดยเพิกเฉยวัตถุที่ไม่เป็น
`Class.Instance.Archivable|Archivable` สำเนาของวัตถุรากจะส่งคืน
โดยวิธีนี้และ `Class.Instance.Parent|Parent` จะถูกตั้งค่าเป็น `nil`
หมายเหตุว่าหากวัตถุเองมีการตั้งค่าเป็น
`Class.Instance.Archivable|Archivable` เป็น `false` ฟังก์ชั่นนี้จะ
ส่งคืน `nil`。

หากมีสมบัติอ้างอิงเช่น `Class.ObjectValue.Value` ถูกตั้งค่าใน
อินสแตนซ์ที่ทำสำเนา ค่าของสมบัติของการคัดลอกจะขึ้นอยู่กับ
ค่าของต้นฉบับ:

- หากสมบัติอ้างอิงอ้างถึงอินสแตนซ์ที่ถูก **คัดลอก** เช่นเดียวกัน
  การคัดลอกจะอ้างถึงการคัดลอก。
- หากมีสมบัติอ้างอิงที่อ้างถึงอินสแตนซ์ที่ **ไม่** ถูกคัดลอก
  ค่านั้นจะได้รับการรักษาไว้ในสำเนา。


Instance:Clone

สร้างสำเนาของวัตถุและลูกหลานทั้งหมดโดยไม่สนใจวัตถุ
ที่ไม่ใช่ `Class.Instance.Archivable|Archivable`。


สาธิตการทำลาย Part โดยใช้ฟังก์ชัน `Class.Instance:Destroy()`.

ฟังก์ชันนี้เป็นวิธีที่ถูกต้องในการกำจัดวัตถุที่ไม่ต้องการอีกต่อไป.

ตั้งค่าสมบัติ `Class.Instance.Parent` เป็น `nil`, ล็อค
สมบัติ `Class.Instance.Parent`, ตัดการเชื่อมต่อทั้งหมด และเรียก
`Destroy()` บนลูกหลานทั้งหมด ฟังก์ชันนี้คือวิธีที่ถูกต้องในการกำจัด
วัตถุที่ไม่จำเป็นอีกต่อไป。

การกำจัดวัตถุที่ไม่จำเป็นสำคัญ เนื่องจากวัตถุและการเชื่อมต่อที่ไม่จำเป็นใน
สถานที่ใช้หน่วยความจำซึ่งอาจนำไปสู่ปัญหาประสิทธิภาพที่ร้ายแรงเมื่อเวลาผ่านไป

เป็นแนวทางที่ดีที่สุดหลังจากเรียก `Destroy()` บนวัตถุ ตั้งค่า
ตัวแปรใด ๆ ที่อ้างถึงวัตถุ (หรือลูกหลานของมัน) เป็น `nil` นี่จะช่วยป้องกัน
โค้ดของคุณจากการเข้าถึงใด ๆ ที่เกี่ยวข้องกับวัตถุ。

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- อย่าทำแบบนี้:
print(part.Name)  --> "Hello, world"
-- ทำแบบนี้เพื่อป้องกันบรรทัดด้านบนจากการทำงาน:
part = nil
```
เมื่อ `Class.Instance` ถูกทำลายโดยวิธีนี้ ไม่สามารถนำกลับมาใช้ใหม่ได้
เพราะสมบัติ `Class.Instance.Parent` ถูกล็อค เพื่อที่จะ **เอาออกชั่วคราว**
วัตถุแทนการทำลาย ตั้งค่า `Class.Instance.Parent|Parent` เป็น `nil` ตัวอย่างเช่น:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
เพื่อทำลายวัตถุหลังจากเวลาที่กำหนดใช้
`Class.Debris:AddItem()`。


Instance:Destroy

ตั้งค่าสมบัติ `Class.Instance.Parent` เป็น `nil`, ล็อค
สมบัติ `Class.Instance.Parent`, ตัดการเชื่อมต่อทั้งหมด และเรียก
`Destroy()` บนลูกหลานทั้งหมด。


ส่งคืนบิดเบี้ยวแรกของ `Class.Instance` ซึ่งมี
`Class.Instance.Name` เท่ากับชื่อที่กำหนด。

ฟังก์ชันนี้ทำงานจากด้านบน ซึ่งหมายความว่ามันเริ่มจาก
`Class.Instance.Parent` ที่อยู่ใกล้ที่สุดของอินสแตนซ์และทำงานขึ้นไป
จนถึง `Class.DataModel` หากไม่พบบิดเบี้ยวที่ตรงกัน มันจะส่งคืน `nil`。

โค้ดตัวอย่างต่อไปนี้จะค้นหาบิดเบี้ยวแรกของวัตถุที่ชื่อว่า
`Car`。

```
local car = object:FindFirstAncestor("Car")
```
สำหรับเวอร์ชันของฟังก์ชันนี้ที่ค้นหาบิดเบี้ยวของคลาสเฉพาะ
โปรดดูที่ `Class.Instance:FindFirstAncestorOfClass()` และ
`Class.Instance:FindFirstAncestorWhichIsA()`。


Instance:FindFirstAncestor

name

ชื่อ `Class.Instance.Name` ที่จะค้นหา。


วัตถุ `Class.Instance` ที่พบ。


ส่งคืนบิดเบี้ยวแรกของ `Class.Instance` ซึ่งมี
`Class.Instance.Name` เท่ากับชื่อที่กำหนด。


ส่งคืนบิดเบี้ยวแรกของ `Class.Instance` ซึ่งมี
`Class.Object.ClassName` เท่ากับชื่อคลาสที่กำหนด。

ฟังก์ชันนี้ทำงานจากด้านบน ซึ่งหมายความว่าเริ่มต้นจาก
`Class.Instance.Parent` ที่อยู่ใกล้ที่สุดของอินสแตนซ์และทำงานขึ้นไป
จนถึง `Class.DataModel` หากไม่พบบิดเบี้ยวที่ตรงกัน มันจะส่งคืน `nil`。

การใช้งานทั่วไปของฟังก์ชันนี้คือค้นหาว่า `Class.Model` ที่
`Class.BasePart` เป็นของ อยู่ที่ไหน เช่น:

```
local model = part:FindFirstAncestorOfClass("Model")
```
ฟังก์ชันนี้เป็นเวอร์ชันของ `Class.Instance:FindFirstAncestor()` ซึ่ง
ตรวจสอบสมบัติ `Class.Object.ClassName` แทน `Class.Instance.Name`。
`Class.Instance:FindFirstAncestorWhichIsA()` ยังมีอยู่ ซึ่งใช้
วิธี `Class.Object:IsA()` แทนเพื่อเคารพการสืบเชื้อสายของคลาส。


Instance:FindFirstAncestorOfClass

className

ชื่อ `Class.Object.ClassName` ที่จะค้นหา。


ส่งคืนบิดเบี้ยวแรกของ `Class.Instance` ซึ่งมี
`Class.Object.ClassName` เท่ากับชื่อคลาสที่กำหนด。


ส่งคืนบิดเบี้ยวแรกของ `Class.Instance` ซึ่ง
`Class.Object:IsA()` ส่งคืน true สำหรับชื่อคลาสที่กำหนด。

ฟังก์ชันนี้ทำงานจากด้านบน ซึ่งหมายความว่ามันเริ่มจาก
`Class.Instance.Parent` ที่อยู่ใกล้ที่สุดของอินสแตนซ์และทำงานขึ้นไป
จนถึง `Class.DataModel` หากไม่พบบิดเบี้ยวที่ตรงกัน มันจะส่งคืน `nil`。

แตกต่างจาก `Class.Instance:FindFirstAncestorOfClass()` ฟังก์ชันนี้ใช้
`Class.Object:IsA()` ซึ่งมีความเคารพต่อการสืบเชื้อสายของคลาส ตัวอย่างเช่น:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
ดังนั้นโค้ดตัวอย่างต่อไปนี้จะส่งคืนบิดเบี้ยวแรก
`Class.BasePart` อย่างไรก็ตามคลาส WedgePart,
MeshPart หรือ Part。

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
ดูที่ `Class.Instance:FindFirstAncestor()` ด้วย。


Instance:FindFirstAncestorWhichIsA

ส่งคืนบิดเบี้ยวแรกของ `Class.Instance` ซึ่ง
`Class.Object:IsA()` ส่งคืน true สำหรับชื่อคลาสที่กำหนด。


ด้านล่างนี้จะค้นหาใน Workspace สำหรับวัตถุชื่อ "Brick" หากพบ,
จะเปลี่ยนชื่อของวัตถุเป็น "Foo".

ส่งคืนลูกแรกของ `Class.Instance` ที่มีชื่อที่กำหนด หรือ
`nil` หากไม่มีลูกดังกล่าว หากอาร์กิวเมนต์ `recursive` มีค่าเป็น
`true` ฟังก์ชันนี้จะค้นหาทุกลูกหลานแทนที่จะมีลูกทันทีของ `Class.Instance`。

##### ตรวจสอบการมีอยู่ของวัตถุ

`FindFirstChild()` เป็นสิ่งจำเป็นหากคุณต้องการตรวจสอบว่าวัตถุมีอยู่
ก่อนที่จะดำเนินการต่อไป ความพยายามในการ index เด็กโดยชื่อใช้ผู้ดำเนินการจุดจะดึงข้อผิดพลาด
หากไม่มีลูกให้ทดสอบ。

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

-- บรรทัดต่อไปนี้จะส่งข้อผิดพลาดหากหลังไม่อยู่ในเวิร์กสเปซ
Workspace.Part.Transparency = 0.5
```
แนวทางที่ดีที่สุดคือการใช้ `FindFirstChild()` เพื่อเช็ค `Part` ก่อน
จากนั้นใช้ `if` เพื่อดำเนินการโค้ดที่ต้องการ。

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

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

##### ค้นหาลูกที่มีชื่อที่ตรงกับสมบัติ

บางครั้งชื่อ `Class.Instance.Name|Name` ของวัตถุจะตรงกับสมบัติของ
`Class.Instance.Parent|Parent` เมื่อใช้ตัวดำเนินการจุด คุณสมบัติจะมีลำดับความสำคัญ
มากกว่าลูกหากมีชื่อเดียวกัน。

ในตัวอย่างต่อไปนี้ จะมี `Class.Folder` ที่เรียกว่า `Color` เพิ่มเข้าไปใน
`Class.Part` ซึ่งยังมีสมบัติ `Class.Part.Color` สังเกตว่า
`part.Color` หมายถึงค่าของสมบัติ `Datatype.Color3` ไม่ใช่ประการของเด็ก
`Class.Folder` การเลือกใช้
`Class.Instance:FindFirstChild()|FindFirstChild()` เป็นข้อดีในการป้องกันไม่ให้การ
เพิ่มสมบัติใหม่ก่อให้เกิดปัญหากับโค้ดของคุณ。

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- สมบัติ
local c2 = part:FindFirstChild("Color")  -- โฟลเดอร์เด็ก
```

##### หมายเหตุเกี่ยวกับประสิทธิภาพ

`Class.Instance:FindFirstChild()|FindFirstChild()` ใช้เวลาประมาณ 20% มากกว่าการใช้
ตัวดำเนินการจุดและเกือบ 8 เท่ามากกว่าการเก็บอ้างอิงไปยังวัตถุ
ดังนั้นคุณควรหลีกเลี่ยงการเรียกใช้งานในโค้ดที่ขึ้นอยู่กับประสิทธิภาพ
เช่นในลูปแน่นหนาหรือฟังก์ชันที่เชื่อมต่อกับ `Class.RunService.Heartbeat`
และ `Class.RunService.PreRender` แทนที่จะเก็บไว้ในตัวแปรหรือพิจารณาใช้
`Class.Instance.ChildAdded|ChildAdded` หรือ
`Class.Instance:WaitForChild()|WaitForChild()` เพื่อตรวจจับเมื่อมีเด็กชื่อดังกล่าว
ที่จะถูกนำไปใช้。

Instance:FindFirstChild

recursive

ว่าการค้นหาควรดำเนินการแบบ recursive หรือไม่。


ส่งคืนลูกแรกของ `Class.Instance` ที่พบตามชื่อที่กำหนด。


ส่งคืนลูกแรกของ `Class.Instance` ซึ่ง
`Class.Object.ClassName|ClassName` เท่ากับ `className` ที่กำหนด。
แตกต่างจาก `Class.Instance:FindFirstChildWhichIsA()` ฟังก์ชันนี้จะเพียง
ส่งคืนวัตถุที่ตรงกับ `className` โดยเพิกเฉยเรื่องสืบเชื้อสายคลาส
หากไม่พบบุตรที่ตรงกันฟังก์ชั่นนี้ส่งคืน `nil`。


Instance:FindFirstChildOfClass

ส่งคืนลูกแรกของ `Class.Instance` ซึ่ง
`Class.Object.ClassName|ClassName` เท่ากับชื่อคลาสที่กำหนด。


ส่งคืนลูกแรกของ `Class.Instance` ซึ่ง
`Class.Object:IsA()` ส่งคืน true สำหรับชื่อคลาสที่กำหนด。

หากไม่พบลูกที่ตรงกันฟังก์ชันนี้ส่งคืน `nil` หากอาร์กิวเมนต์
recursive เป็นจริงฟังก์ชันนี้จะค้นหาลูกทั้งหมด
แทนที่จะเป็นลูกที่ใกล้ที่สุดของ `Class.Instance`。

แตกต่างจาก `Class.Instance:FindFirstChildOfClass()` ฟังก์ชั่นนี้ใช้
`Class.Object:IsA()` ซึ่งมีความเคารพต่อการสืบเชื้อสายของคลาส ตัวอย่างเช่น:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
ดังนั้น ตัวอย่างโค้ดต่อไปนี้ จะส่งคืนลูก `Class.BasePart` แรก
ไม่ว่าจะเป็น `Class.WedgePart`, `Class.MeshPart` หรือ `Class.Part`。

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
นักพัฒนาที่มองหาลูกโดยชื่อควรที่จะใช้
`Class.Instance:FindFirstChild()` แทน。


Instance:FindFirstChildWhichIsA

ส่งคืนลูกแรกของ `Class.Instance` ซึ่ง
`Class.Object:IsA()` ส่งคืน true สำหรับชื่อคลาสที่กำหนด。


ส่งคืนลูกหลานแรกที่พบจากชื่อ `Class.Instance.Name` ที่กำหนด。

เมธอดนี้ถูกปิดใช้งานและไม่สามารถใช้ได้ หากต้องการค้นหาลูกหลานแรก
ของอินสแตนซ์โปรดพิจารณาใช้พารามิเตอร์ `recursive` บน
`Class.Instance:FindFirstChild()` แทน。


Instance:FindFirstDescendant

ส่งคืนลูกหลานแรกที่พบจากชื่อ `Class.Instance.Name` ที่กำหนด。


หาก `Class.Instance` เป็น `Class.Actor` จะส่งคืน `Class.Actor` เอง มิฉะนั้น
จะส่งคืนบิดเบี้ยวที่ใกล้ที่สุดเป็น `Class.Actor` หากไม่มี
บรรพบุรุษเป็น `Class.Actor` ผลลัพธ์คือ `nil`。


Instance:GetActor

วัตถุ `Class.Actor` ที่พบ。


ส่งคืน `Class.Actor` ที่สัมพันธ์กับอินสแตนซ์ หากมี。


วิธีนี้ส่งคืนค่าที่ถูกกำหนดให้กับชื่อคุณสมบัติที่กำหนด หากไม่มีคุณสมบัติ
ที่ถูกกำหนด เป็น `nil` จะถูกส่งคืน。

เช่น ตัวอย่างโค้ดต่อไปนี้ตั้งค่าและจากนั้นดึงค่าของ
คุณสมบัติ `InitialPosition` ของอินสแตนซ์:

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

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

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

##### ดูเพิ่มเติม

- `Class.Instance:SetAttribute()` ซึ่งตั้งค่าคุณสมบัติด้วยชื่อที่กำหนด
  เป็นค่าที่กำหนด
- `Class.Instance:GetAttributes()` ซึ่งส่งคืนดิกชันนารีของคู่คีย์-ค่า
  สำหรับคุณสมบัติของอินสแตนซ์แต่ละรายการ。


Instance:GetAttribute

ชื่อของคุณสมบัติที่ถูกดึงข้อมูล。


ค่าที่ถูกกำหนดให้กับชื่อคุณสมบัติที่กำหนด หากไม่มีคุณสมบัติ
ที่ถูกกำหนด เป็น `nil` จะถูกส่งคืน。


ส่งคืนค่าที่ถูกกำหนดให้กับชื่อคุณสมบัติที่กำหนด。


ฟังก์ชันนี้ส่งคืนเหตุการณ์ที่ทำงานเหมือนกับเหตุการณ์
`Class.Object.Changed|Changed` แต่เปลี่ยนแค่เฉพาะคุณสมบัติที่ให้มาก่อนเท่านั้น;
ในทางปฏิบัติมันมีความคล้ายคลึงกับ `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` แต่
สำหรับคุณสมบัติ。

โดยทั่วไปแล้วมันเป็นของดีที่ใช้วิธีนี้แทนที่จะเชื่อมโยงกับ
`Class.Object.Changed|Changed` ด้วยฟังก์ชันที่ตรวจสอบชื่อคุณสมบัติ。
การเรียกใช้ฟังก์ชันนี้หลายครั้งที่วัตถุเดียวกันด้วยชื่อคุณสมบัติเหมือนกันจะส่งคืนเหตุการณ์เดียวกัน。

ตัวอย่างโค้ดต่อไปนี้ส่งคืนสัญญาณที่เรียกใช้ฟังก์ชัน
`attributeChanged()` เมื่อมีการเปลี่ยนแปลงในคุณสมบัติ
`InitialPosition` ของส่วน:

```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)
```
ดูที่ `Class.Instance.AttributeChanged` ซึ่งเกิดขึ้นเมื่อคุณสมบัติใด ๆ
เปลี่ยนแปลงบนอินสแตนซ์。


Instance:GetAttributeChangedSignal

ชื่อของคุณสมบัติที่ระบุสำหรับการส่งคืนสัญญาณการเปลี่ยนแปลง。


เหตุการณ์ที่เกิดขึ้นเมื่อคุณสมบัติที่กำหนดเปลี่ยนแปลง。


ส่งคืนเหตุการณ์ที่เกิดขึ้นเมื่อคุณสมบัติที่กำหนดเปลี่ยนแปลง。


วิธีนี้ส่งคืนดิกชันนารีของคู่คีย์-ค่าที่แต่ละคุณสมบัติ
ซึ่งคีย์คือชื่อของคุณสมบัติและค่าคือค่าที่ไม่เป็น `nil`。

ตัวอย่างเช่น ตัวอย่างโค้ดต่อไปนี้แสดงผลลัพธ์ของคุณสมบัติ
และค่าของอินสแตนซ์:

```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
```
ดูที่ `Class.Instance:GetAttribute()` ซึ่งส่งคืนค่าที่ถูกกำหนดให้กับ
ชื่อคุณสมบัติที่กำหนด。


Instance:GetAttributes

ดิกชันนารีของคู่ค่า string → variant สำหรับทุกคุณสมบัติที่
ซึ่ง string คือชื่อของคุณสมบัติและ variant ค่าที่ไม่เป็น `nil`。


ส่งคืนดิกชันนารีของคุณสมบัติของอินสแตนซ์。


ด้านล่างนี้จะแสดงชื่อของวัตถุทั้งหมดที่อยู่ใน Workspace ขณะทำการรัน

ส่งคืนอาเรย์ (ตารางดัชนีเชิงตัวเลข) ที่มีลูกโดยตรงทั้งหมดของ
อินสแตนซ์ หรือทุก `Class.Instance` ที่
the `Class.Instance.Parent|Parent` เป็นออปเจ็กต์ ตารางสามารถวนซ้ำได้
โดยใช้ทั้งลูปเชิงตัวเลขหรือแบบทั่วไป:

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

-- ตัวอย่างการวนรอบแบบตัวเลข
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")

-- ตัวอย่างการวนร่วมทั่วไป
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " is child number " .. i)
end
```
ลูกๆ จะถูกจัดเรียงตามลำดับที่สมบัติ
ของ `Class.Instance.Parent|Parent` ถูกตั้งค่าเป็นวัตถุนั้น。

ดูที่ฟังก์ชัน `Class.Instance:GetDescendants()|GetDescendants` ด้วย。


Instance:GetChildren

อาเรย์ที่มีลูกของอินสแตนซ์。


ส่งคืนอาเรย์ที่มีลูกทั้งหมดของอินสแตนซ์。


ส่งคืนสตริงรหัสของ ID ดีบักที่ใช้ภายในโดย Roblox หมายเหตุว่า:

- รายการนี้ถูกป้องกัน พยายามใช้มันใน `Class.Script` หรือ
  `Class.LocalScript` จะทำให้เกิดข้อผิดพลาด
- ID ดีบักคือ ID ที่ใช้ในกระบวนการดีบัก มันอนุญาตให้ดีบักเกอร์อ่านแต่ละคำสั่ง
ก่อนที่จะประมวลผลโดยแอปพลิเคชัน วัตถุทั้งหมดใน Roblox ทำหน้าที่คล้าย
กับกระบวนการและแต่ละรันจัดการคำสั่ง (หรือ 'โค้ด') ที่สามารถดีบักได้ถ้าจำเป็น
- สิ่งนี้สามารถเป็นประโยชน์สำหรับปลั๊กอินที่ต้องการแยกแยะวัตถุที่คล้ายกัน
จากกัน (เช่นวัตถุที่มีชื่อเดียวกัน)


Instance:GetDebugId

scopeLength

ความยาวของขอบเขต。


ส่งคืนสตริงรหัสของ ID ดีบักที่ใช้ภายในโดย Roblox。


GetDescendants มักถูกใช้เพื่อทำสิ่งต่าง ๆ กับทายาททั้งหมดที่เป็น
ประเภทของวัตถุที่เฉพาะเจาะจง โค้ดในตัวอย่างนี้ใช้ GetDescendants และ
`Class.Instance:IsA()` เพื่อหาเนื้อหาทั้งหมดใน Workspace และเปลี่ยน
ให้เป็นสีเขียว.

วิธีการของอ็อบเจ็กต์นี้จะส่งคืนอาร์เรย์ที่มีทายาททั้งหมด
ของวัตถุพจน์นั้น ต่างจาก `Class.Instance:GetChildren()` ซึ่งจะส่งคืน
เฉพาะเด็กทันทีของวัตถุ วิธีการนี้จะค้นหาทุก ๆ เด็กของวัตถุ, กลับเด็กทุกคนของเด็กเหล่านั้น และต่อไป.


Instance:GetDescendants

อาร์เรย์ที่มีทายาทของอินสแตนซ์.


ส่งคืนอาร์เรย์ที่มีทายาททั้งหมดของอินสแตนซ์.


ตัวอย่างโค้ดนี้แสดงพฤติกรรมของ `Class.Instance:GetFullName()`.
มันแสดงให้เห็นว่าฟังก์ชันทำงานอย่างไรเมื่อถูกเรียกใช้บนวัตถุที่ไม่อยู่ใน
โครงสร้าง `DataModel` และยังแสดงให้เห็นว่าค่าที่ส่งกลับไม่หลบ
อักขระพิเศษ.

ตัวอย่างโค้ดนี้นำเสนอการทำงานของฟังก์ชัน `Class.Instance:GetFullName()` ใหม่ใน
Lua.

ส่งคืนสตริงที่อธิบายถึงบรรพบุรุษของอินสแตนซ์ สตริงนั้นคือ
การรวมกันของ `Class.Instance.Name|Name` ของวัตถุและบรรพบุรุษของมัน
แยกด้วยจุด `Class.DataModel` (`game`) จะไม่ถูกพิจารณา ตัวอย่างเช่น `Class.Part` ใน `Class.Workspace` อาจ
ส่งคืน `Class.Workspace.Part`.

เมื่อเรียกใช้กับ `Class.Instance` ที่ไม่ใช่ทายาทของ
`Class.DataModel` ฟังก์ชันนี้จะพิจารณาทุกบรรพบุรุษขึ้นไปและ
รวมถึงบรรพบุรุษที่สูงที่สุดที่ไม่มี `Class.Instance.Parent|Parent`.

ฟังก์ชันนี้มีประโยชน์สำหรับการบันทึกข้อมูลและการแก้ไขข้อผิดพลาด คุณไม่ควรพยายาม
วิเคราะห์สตริงที่ส่งคืนเพื่อการดำเนินการใด ๆ เพราะฟังก์ชันนี้จะไม่
ทำการหนีจุด (หรือสัญลักษณ์อื่น ๆ) ในชื่อวัตถุ ในคำอื่น ๆ
แม้ว่าผลลัพธ์ของมันมักจะดูเหมือนเป็นตัวระบุของ Luau ที่ถูกต้อง มันไม่ได้
รับประกัน.


Instance:GetFullName

ชื่อเต็มของ `Class.Instance`.


ส่งคืนสตริงที่อธิบายถึงบรรพบุรุษของอินสแตนซ์.


วิธีการนี้ส่งคืนค่าในแบบที่จัดรูปแบบหรือแก้ไขโดยชัดแจ้งของคุณสมบัติที่ระบุ,
หรือค่าเริ่มต้นของคุณสมบัติถ้ายังไม่ได้รับการจัดรูปแบบ/แก้ไข แตกต่างจากการเข้าถึงค่า
คุณสมบัติโดยตรง เช่น `[GuiObject].Rotation` ซึ่งส่งคืนค่าเริ่มต้นหรือค่า
ที่แปรสภาพของคุณสมบัติ.

```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"

-- อ้างอิงถึงปุ่ม
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

print(button:GetStyled("Rotation")) --> 0 (ค่าเริ่มต้น)
print(button.Rotation) --> 0 (ค่าเริ่มต้น)

-- ใช้การหมุนผ่านคุณสมบัติของกฎสไตล์
rule:SetProperty("Rotation", 30)

print(button:GetStyled("Rotation")) --> 30 (ค่าแบบที่จัดรูปแบบตามกฎ)
print(button.Rotation) --> 0 (ค่าเริ่มต้น)

-- แก้ไข/เหนือคุณสมบัติที่จัดรูปแบบโดยชัดแจ้ง
button.Rotation = 45

print(button:GetStyled("Rotation")) --> 45 (ค่าแปรสภาพ)
print(button.Rotation) --> 45 (ค่าแปรสภาพ)
```


Instance:GetStyled

ชื่อของคุณสมบัติที่ต้องการสอบถาม.


ค่าในแบบที่จัดรูปแบบหรือแก้ไขโดยชัดแจ้งของคุณสมบัติที่ระบุ,
หรือค่าเริ่มต้นของคุณสมบัติถ้ายังไม่ได้รับการจัดรูปแบบ/แก้ไข.


ส่งคืนค่าในแบบที่จัดรูปแบบหรือแก้ไขโดยชัดแจ้งของคุณสมบัติที่ระบุ,
หรือค่าเริ่มต้นของคุณสมบัติถ้ายังไม่ได้ถูกจัดรูปแบบ/แก้ไข.


วิธีการนี้ส่งคืนเหตุการณ์ที่ทำงานเช่นเดียวกับ
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` กรณีนี้คือ
มันจะทำงานเฉพาะเมื่อคุณสมบัติรูปแบบที่กำหนดมีการเปลี่ยนแปลง มันมักจะเป็นแนวทางที่ดี
ในการใช้วิธีนี้แทนที่จะเชื่อมโยงกับ `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`
ที่มีฟังก์ชันตรวจสอบชื่อคุณสมบัติ การเรียกใช้วิธีนี้ซ้ำบนวัตถุเดียวกันที่มีชื่อคุณสมบัติเหมือนเดิม
จะส่งคืนเหตุการณ์เดียวกัน.

โปรดทราบว่าเหตุการณ์นี้จะไม่ส่งผ่านพารามิเตอร์ใด ๆ ไปยังฟังก์ชันที่เชื่อมโยง,
ดังนั้นค่าของคุณสมบัติที่เปลี่ยนแปลงจะต้องอ่านโดยตรงภายใน
สคริปต์.

```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("คุณสมบัติรูปแบบถูกเปลี่ยนแปลง!")
end

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


Instance:GetStyledPropertyChangedSignal

property

ชื่อของคุณสมบัติรูปแบบที่ต้องการฟังการเปลี่ยนแปลง.


เหตุการณ์ที่ทำงานเมื่อคุณสมบัติรูปแบบที่กำหนดมีการเปลี่ยนแปลง.


วิธีการนี้ส่งคืนอาร์เรย์ของแท็กที่ใช้กับอินสแตนซ์ที่ระบุในรูปแบบ
ของสตริง คุณสามารถเพิ่มแท็กได้ทั้งใน Studio ใน
[Properties](/studio/properties) หน้าต่างหรือในขณะรันตลอดด้วย
`Class.Instance:AddTag()|AddTag()`.

วิธีการนี้มีประโยชน์เมื่อคุณต้องการทำอะไรกับแท็กหลาย ๆ อันบน
อินสแตนซ์ในครั้งเดียว อย่างไรก็ตาม, มันไม่ประหยัดที่จะใช้วิธีนี้ในการ
ตรวจสอบการมีอยู่ของแท็กเดียว; แทนที่จะใช้
`Class.Instance:HasTag()|HasTag()` เพื่อตรวจสอบแท็กเฉพาะ.


Instance:GetTags

ได้รับอาร์เรย์ของแท็กทั้งหมดที่ใช้กับอินสแตนซ์.


วิธีนี้จะส่งคืน `true` หากแท็กที่ให้มีการเพิ่มเข้าไปใน
วัตถุนั้น คุณสามารถเพิ่มแท็กได้ทั้งใน Studio ใน
[Properties](/studio/properties) หน้าต่างหรือที่รันไทม์ด้วย
`Class.Instance:AddTag()|AddTag()`.


Instance:HasTag

ตรวจสอบว่าอินสแตนซ์มีแท็กที่กำหนดหรือไม่.


แสดงให้เห็นถึงการกำหนดว่าชิ้นส่วนหนึ่งเป็นบรรพบุรุษของอีกชิ้นหนึ่งโดยใช้ `Class.Instance:IsAncestorOf()`

Workspace และ SpawnLocation เป็นบรรพบุรุษของ decal ของ SpawnLocation.
Workspace เป็นบรรพบุรุษของ SpawnLocation.

SpawnLocation และ decal ของมันเป็นลูกรองของ Workspace ไม่ใช่บรรพบุรุษ.
Decal เป็นลูกย่อยของ SpawnLocation ไม่ใช่บรรพบุรุษ.

ส่งคืน true หาก `Class.Instance` เป็นบรรพบุรุษของทายาทที่กำหนด.

`Class.Instance` จะถือว่าเป็นบรรพบุรุษของวัตถุถ้า
`Class.Instance.Parent` ของวัตถุหรือพ่อ (หนึ่งในพ่อของมัน)
`Class.Instance.Parent` ถูกตั้งไปที่ `Class.Instance`.

ดูเพิ่มเติมได้ที่ `Class.Instance:IsDescendantOf()`.


Instance:IsAncestorOf

True หาก `Class.Instance` เป็นบรรพบุรุษของทายาทที่กำหนด.


ส่งคืน true หาก `Class.Instance` เป็นบรรพบุรุษของทายาทที่กำหนด.


ส่งคืน `true` หาก `Class.Instance` เป็นทายาทของบรรพบุรุษที่กำหนด.

โปรดทราบว่า `IsDescendantOf()` ไม่สามารถใช้กับพารามิเตอร์ที่เป็น `nil` เพื่อตรวจสอบ
ว่าวัตถุได้ถูกลบออกหรือไม่.

ดูเพิ่มเติมที่ `Class.Instance:IsAncestorOf()`.


Instance:IsDescendantOf

ancestor

บรรพบุรุษ `Class.Instance`.


True หาก `Class.Instance` เป็นทายาทของบรรพบุรุษที่กำหนด.


ส่งคืน `true` หาก `Class.Instance` เป็นทายาทของบรรพบุรุษที่กำหนด.


ส่งคืน `true` หากค่าในคุณสมบัติที่ระบุเท่ากับค่าเริ่มต้นที่ใช้ในการสร้างด้วยโค้ด หาก
ในกรณีการแสดงผลของคุณสมบัติ `Class.TextLabel.TextSize|TextSize` ของ `Class.TextLabel`
แสดงผล `8`, จากนั้นเรียก `IsPropertyModified("TextSize")` บนป้ายจะส่งคืน `false`
เพราะ `8` เป็นค่าเริ่มต้นสำหรับ
`Class.TextLabel.TextSize` เมื่อแท็กถูกสร้างผ่าน
`Instance.new("TextLabel")` แทนที่จะถูกแทรกผ่านวิธีการแทรกใน Studio.

โปรดทราบว่าหากวิธีนี้ส่งคืน `true`, การจัดรูปแบบจะ **ไม่** มีผลต่อ
คุณสมบัติเนื่องจากการปรับเปลี่ยนอย่างชัดแจ้งค่าของคุณสมบัติจะมีลำดับความสำคัญเหนือ
การจัดรูปแบบ.


Instance:IsPropertyModified

Boolean แสดงว่าคุณสมบัติถูกแก้ไข.


ส่งคืน `true` หากค่าในคุณสมบัติที่ระบุเท่ากับค่าเริ่มต้นที่ใช้ในการสร้าง
ด้วยโค้ด.


โค้ดต่อไปนี้แสดงให้เห็นว่าส่วนหนึ่งสามารถถูกเพิ่มกลับเข้าสู่ DataModel
หลังจากถูกลบออก:

ฟังก์ชันนี้ตั้งค่า `Class.Instance.Parent` ของวัตถุเป็น `nil`, และทำเช่นเดียวกันกับทายาททั้งหมดของมัน.

ถ้าวัตถุถูกอ้างอิงก่อนที่จะถูกลบออก มันสามารถที่จะ
เรียกคืนวัตถุในภายหลังได้.


Instance:Remove

ตั้งค่า `Parent` ของวัตถุเป็น `nil`, และทำเช่นเดียวกันกับทายาททั้งหมด.


วิธีการนี้ลบแท็กออกจากอินสแตนซ์ มันจะไม่เกิดข้อผิดพลาดหาก
วัตถุไม่มีแท็ก การลบแท็กออกอย่างสำเร็จจะทำให้เกิดสัญญาณที่สร้างโดย
`Class.CollectionService:GetInstanceRemovedSignal()`
พร้อมแท็กที่กำหนด.

โปรดทราบว่าเมื่อทำการติดแท็กอินสแตนซ์ มักจะใช้ทรัพยากรบางอย่างเพื่อให้แท็กทำงานได้,
เช่น การเชื่อมต่อเหตุการณ์หรือตาราง ในการป้องกันการรั่วไหลของหน่วยความจำ
นี่เป็นแนวคิดที่ดีในการทำความสะอาดสิ่งเหล่านี้ (ยกเลิกการเชื่อมต่อ, ตั้งค่าเป็น `nil`, เป็นต้น)
เมื่อไม่ต้องการสำหรับแท็กอีกต่อไป.


Instance:RemoveTag

ลบแท็กออกจากอินสแตนซ์.


รีเซ็ตค่าคุณสมบัติเป็นค่าเริ่มต้น เช่น การเรียก
`ResetPropertyToDefault("Rotation")` บน `Class.TextLabel` เทียบเท่ากับการตั้งค่า
`Class.TextLabel.Rotation|Rotation` เป็น `0` (ค่าคุณสมบัติเริ่มต้น) วิธีการนี้สามารถใช้เพื่อให้การจัดรูปแบบ
จะมีผลเหนือกว่าค่าคุณสมบัติเริ่มต้นนี้.


Instance:ResetPropertyToDefault

ชื่อของคุณสมบัติที่ต้องการรีเซ็ต.


รีเซ็ตค่าคุณสมบัติเป็นค่าเริ่มต้น.


Instance

`Instance` เป็นคลาสพื้นฐานสำหรับคลาสทั้งหมดในลำดับชั้นคลาส Roblox
ซึ่งสามารถเป็นส่วนหนึ่งของต้นไม้ `Class.DataModel`。


/reference/engine/classes/KeyframeSequenceProvider.yaml