**LayerCollector** เป็นคลาสพื้นฐานของ 2D UI containers ที่เรนเดอร์
`Class.GuiObject` descendants เช่น `Class.ScreenGui`。

เพื่อปรับปรุงประสิทธิภาพ รูปลักษณ์ของ `Class.LayerCollector` จะ
ถูกเก็บไว้ในแคชจนกว่าจะเกิดหนึ่งในเหตุการณ์ต่อไปนี้:

- มีการเพิ่มหรือลบ descendant ออกจากมัน。
- คุณสมบัติของ descendant มีการเปลี่ยนแปลง。
- คุณสมบัติของ `Class.LayerCollector` เองมีการเปลี่ยนแปลง。


LayerCollector:GetLayoutNodeTree

LayerCollector

เปลี่ยนแปลงความสามารถในการมองเห็นของ `Class.LayerCollector` นี้ เมื่อ `false` ข้อมูล UI
จะไม่ถูกเรนเดอร์, ไม่ประมวลผลการป้อนข้อมูลของผู้ใช้ หรืออัปเดตเพื่อตอบสนองต่อ
การเปลี่ยนแปลง。


LayerCollector.Enabled

เปลี่ยนแปลงความสามารถในการมองเห็นของ `Class.LayerCollector` นี้。


เมื่อถูกตั้งค่าเป็น `false` และ `Class.LayerCollector` นี้เป็นลูกของ
`Class.StarterGui` โดยตรง จะถูกคัดลอกไปยัง `Class.PlayerGui` ของผู้เล่นแต่ละคน
เพียงครั้งเดียวและจะไม่ถูกลบเมื่อตัวละครของผู้เล่นเกิดใหม่。

เมื่อถูกตั้งค่าเป็น `true` (ค่าเริ่มต้น) หรือถ้า `Class.LayerCollector`
นี้เป็น descendant **นิยามไม่ตรง** ของ `Class.StarterGui` จะถูกคัดลอกไปยัง `Class.PlayerGui`
ของผู้เล่นแต่ละคนเมื่อตัวละครของพวกเขาเกิดใหม่ และมันจะลบตัวเองเมื่อ
ตัวละครของผู้เล่นเกิดใหม่อีกครั้ง。


LayerCollector.ResetOnSpawn

กำหนดว่าคลาส `Class.LayerCollector` จะรีเซ็ต (ลบตัวเองและ
คัดลอกใหม่ไปยัง `Class.PlayerGui` ของผู้เล่น) ทุกครั้งที่ตัวละครผู้เล่น
เกิดใหม่หรือไม่。


ควบคุมว่าพฤติกรรมของ `Class.GuiObject.ZIndex` เป็นอย่างไรใน descendants ทั้งหมดของ
`Class.LayerCollector` นี้。

ด้วย `Enum.ZIndexBehavior.Sibling` (ค่าเริ่มต้น) เด็กจะถูกเรนเดอร์อยู่เหนือ
พ่อแม่เสมอ และ `Class.GuiObject.ZIndex|ZIndex` จะถูกใช้ในการตัดสิน
ลำดับที่เด็กของ UI object เดียวกันจะเรนเดอร์ซ้อนทับกัน。

`Enum.ZIndexBehavior.Global` จะจัดเรียง descendants ทั้งหมดตาม
`Class.GuiObject.ZIndex|ZIndex` จากนั้นจะตัดสินความเท่าเทียมกันด้วยลำดับ
ของลำดับชั้น result. ดังนั้น descendants ของ `Class.GuiObject` ต้องมี
ค่า `Class.GuiObject.ZIndex|ZIndex` ที่สูงอย่างน้อยเท่ากับ
พ่อแม่，否则它们将渲染在它们的父级下。


LayerCollector.ZIndexBehavior

ควบคุมว่าพฤติกรรมของ `Class.GuiObject.ZIndex` เป็นอย่างไรใน descendants ทั้งหมดของ
`Class.LayerCollector` นี้。


คลาสพื้นฐานของ 2D UI containers ที่เรนเดอร์ `Class.GuiObject|GuiObjects`
ในเลเยอร์。


`Class.GuiBase2d` เป็นคลาสนามที่ถูกสืบทอดโดย 2D
`Class.GuiObject|GuiObjects`.


เหตุการณ์นี้เกิดขึ้นเมื่อการเลือกของเกมพัดเคลื่อนที่ไปยัง, ออกจาก,
หรือเปลี่ยนภายใน `Class.GuiBase2d` ที่เชื่อมต่อหรือบุตรของมัน
`Class.GuiObject|GuiObjects`. เมื่อการเลือกไฮไลท์เคลื่อนที่ไปยัง
`Class.GuiObject`, เหตุการณ์จะบับเบิ้ลจาก `Class.GuiObject` นั้นไปยังบรรพบุรุษทั้งหมด,
แจ้งให้พวกเขาทราบว่าการเลือกได้
เปลี่ยน/เข้าหรือออกจาก `Class.GuiObject` ในต้นไม้บุตรของพวกเขา.


GuiBase2d.SelectionChanged

amISelected

เป็นจริงถ้าการเลือกใหม่ตรงกับ GuiBase2d ที่ติดตั้ง.


previousSelection

newSelection

เกิดเหตุการณ์ขึ้นเมื่อการเลือกของเกมพัดเคลื่อนที่ไปยัง, ออกจาก, หรือเปลี่ยนภายใน
`Class.GuiBase2d` ที่เชื่อมต่อหรือบุตรของมัน
`Class.GuiObject|GuiObjects`.


GuiBase2d

`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` เป็นคุณสมบัติที่อ่านได้เพียงอย่างเดียว
ที่ให้ตำแหน่งหน้าจอขององค์ประกอบ `Class.GuiBase2d` ใน
พิกเซล. นี่คือค่าตำแหน่งพิกเซลจริงที่องค์ประกอบแสดงผลจากขนาด
และตำแหน่งของบรรพบุรุษของมัน. หมายเหตุว่า
`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` จะบ่งบอกถึงมุมซ้าย-บน
ขององค์ประกอบ `Class.GuiBase2d` เสมอ.

ถ้า `Class.GuiBase2d` อยู่ใน `Class.ScreenGui`, คุณสมบัติ
`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` จะใช้ระบบพิกัด
`Enum.ScreenInsets|CoreUISafeInsets`. ตำแหน่งเริ่มต้นของระบบพิกัดนี้
ตั้งอยู่ที่มุมล่างซ้ายของแถบด้านบนของ Roblox. หมายเหตุว่านี่เป็นระบบพิกัดเดียวกันที่ใช้โดย
คุณสมบัติ `Class.InputObject.Position`.

<img src="/assets/engine-api/classes/GuiBase2d/AbsolutePositionCoordinateSystem.png" width="840" alt="แผนภูมิแสดงตำแหน่งเริ่มต้นของระบบพิกัด AbsolutePosition." />

ดูเพิ่มเติมที่ `Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` และ
`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.


GuiBase2d.AbsolutePosition

อธิบายตำแหน่งจริงบนหน้าจอขององค์ประกอบ `Class.GuiBase2d` ใน
พิกเซล.


`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` เป็นคุณสมบัติที่อ่านได้เพียงอย่างเดียว
ที่อธิบายการหมุนหน้าจอจริงขององค์ประกอบ `Class.GuiBase2d`
ในองศา. มันจะ **ไม่** ทำการตรวจสอบขอบเขต, ดังนั้นค่าของมัน
อาจไม่อยู่ในช่วง `0` ถึง `360`.

ดูเพิ่มเติมที่ `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` และ
`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.


GuiBase2d.AbsoluteRotation

อธิบายการหมุนหน้าจอจริงขององค์ประกอบ `Class.GuiBase2d` ใน
องศา.


`Class.GuiBase2d.AbsoluteSize|AbsoluteSize` เป็นคุณสมบัติที่อ่านได้เพียงอย่างเดียว
ที่อธิบายขนาดหน้าจอจริงขององค์ประกอบ `Class.GuiBase2d` ใน
พิกเซล.

ดูเพิ่มเติมที่ `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` และ
`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation`.


GuiBase2d.AbsoluteSize

อธิบายขนาดหน้าจอจริงขององค์ประกอบ `Class.GuiBase2d` ใน
พิกเซล.


เมื่อถูกตั้งค่าเป็น `true`, จะมีการประยุกต์ใช้การแปลภาษากับ `Class.GuiBase2d`
และบุตรของมัน. รายการที่ใช้ในการแปลภาษาเป็นชุดเดียวกับ
รายการที่ส่งคืนโดย `Class.LocalizationService:GetTableEntries()`. รายการที่
มีคุณสมบัติ `Class.GuiBase2d.AutoLocalize|AutoLocalize` เปิดใช้งานจะถูกแปลใหม่โดยอัตโนมัติ
หลังจากโหลดตารางคลาวด์หากจำเป็น.

ดูเพิ่มเติมที่ `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable`.


GuiBase2d.AutoLocalize

เมื่อถูกตั้งค่าเป็น `true`, จะมีการประยุกต์ใช้การแปลภาษากับ `Class.GuiBase2d`
และบุตรของมัน.


คุณสมบัตินี้จะถูกตั้งค่าโดยอัตโนมัติเป็นจริงเมื่อรากของตารางการแปลภาษาตั้งเป้าไปที่วัตถุ
นี้ หรือบรรพบุรุษของวัตถุนี้. `Class.LocalizationTable|LocalizationTables` ที่มี
คุณสมบัติ `Class.LocalizationTable.Root` ชี้ไปที่อินสแตนซ์จะทำการแปลภาษาทั้งหมดให้กับ
`Class.TextLabel.TextButton` ที่เป็นบุตรของราก.


GuiBase2d.Localize

ตั้งค่าโดยอัตโนมัติเป็นจริงเมื่อรากของตารางการแปลภาษาตั้งเป้าไปที่วัตถุ
นี้ หรือบรรพบุรุษของวัตถุนี้.


การอ้างอิงถึง `Class.LocalizationTable` ที่จะใช้เพื่อประยุกต์ใช้การแปลภาษาอัตโนมัติ
กับ `Class.GuiBase2d` และบุตรของมัน.
`Class.GuiBase2d.AutoLocalize|AutoLocalize` ต้องถูกตั้งค่าเป็น `true` บน
`Class.GuiBase2d` และบรรพบุรุษของมันเพื่อให้การแปลภาษาที่อัตโนมัติถูกนำไปใช้.

คุณสามารถตั้งค่านี้เพื่ออ้างอิงถึง `Class.LocalizationTable` ที่ใดก็ได้ใน
`Class.DataModel`. วัตถุ `Class.GuiBase2d` และลูกทั้งหมดของมัน
จะพยายามใช้ `Class.LocalizationTable` และบรรพบุรุษของมันเฉพาะเจาะจงนั้น
เพื่อการแทนที่ข้อความอัตโนมัติก่อนที่จะใช้ตารางที่อยู่ภายใต้
`Class.LocalizationService` ในลำดับที่ไม่กำหนดและตารางคลาวด์.

หากไม่พบการแปลในตารางที่อ้างถึง, มันจะค้นหาการแปลในผู้ปกครองของตารางนั้น,
หากมันยังเป็น `Class.LocalizationTable`, และอื่น ๆ.

ดูเพิ่มเติมที่ `Class.LocalizationService:GetTableEntries()` ซึ่งจะอธิบายว่าคุณสมบัติ
`Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable` ถูกใช้อย่างไรสำหรับ
การแปลภาษาอัตโนมัติ.


GuiBase2d.RootLocalizationTable

การอ้างอิงถึง `Class.LocalizationTable` ที่จะใช้เพื่อประยุกต์ใช้การแปลภาษาอัตโนมัติ
กับ `Class.GuiBase2d` และบุตรของมัน.


ปรับแต่งพฤติกรรมการเลือกของเกมพัดในทิศทางลง.


GuiBase2d.SelectionBehaviorDown

ปรับแต่งพฤติกรรมการเลือกของเกมพัดในทิศทางซ้าย.


GuiBase2d.SelectionBehaviorLeft

ปรับแต่งพฤติกรรมการเลือกของเกมพัดในทิศทางขวา.


GuiBase2d.SelectionBehaviorRight

ปรับแต่งพฤติกรรมการเลือกของเกมพัดในทิศทางขึ้น.


GuiBase2d.SelectionBehaviorUp

อนุญาตให้ปรับแต่งวิธีการที่การเลือกของเกมพัดสามารถเคลื่อนที่ระหว่าง
ปุ่มต่าง ๆ ที่เป็นบุตรของกลุ่มการเลือก, ออกจากกลุ่ม,
และเลือกปุ่มอื่น ๆ.

การตั้งค่า `Class.GuiBase2d.SelectionGroup|SelectionGroup` เป็น `true`
จะเปิดให้คุณสมบัติ
`Class.GuiBase2d.SelectionBehaviorUp|SelectionBehaviorUp`,
`Class.GuiBase2d.SelectionBehaviorDown|SelectionBehaviorDown`,
`Class.GuiBase2d.SelectionBehaviorLeft|SelectionBehaviorLeft`, และ
`Class.GuiBase2d.SelectionBehaviorRight|SelectionBehaviorRight`.
สำหรับพฤติกรรมการเลือกเหล่านี้, การตั้งค่า `Enum.SelectionBehavior.Escape` (ค่าเริ่มต้น)
หมายความว่าการเลือกของเกมพัดจะพยายามค้นหาการเลือกภายในกลุ่มการเลือกก่อน
และจะเคลื่อนที่นอกกลุ่มเฉพาะเมื่อไม่พบปุ่มที่เหมาะสม. หรืออีกทางหนึ่ง, การตั้งค่า `Enum.SelectionBehavior.Stop`
หมายความว่าการเลือกของเกมพัดจะมองหาเฉพาะภายในกลุ่มการเลือกเท่านั้น
และจะไม่เคลื่อนที่ออกจากกลุ่มจากทิศทางของพฤติกรรมการเลือก.


GuiBase2d.SelectionGroup

อนุญาตให้ปรับแต่งการเคลื่อนที่ของการเลือกของเกมพัด.


คลาสนามที่ถูกสืบทอดโดย `Class.GuiObject|GuiObjects` 2D.


GuiBase เป็นคลาสนามธรรมที่วัตถุส่วนใหญ่ในอินเตอร์เฟสผู้ใช้กราฟิก
สืบทอดมาจาก


GuiBase

`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

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


Instance

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


/reference/engine/classes/LayerCollector.yaml