`CanvasGroup` ใช้ในการเรนเดอร์ลูกหลานเป็นกลุ่มโดยมีสีและความโปร่งใส
ที่ใช้กับผลลัพธ์จากการเรนเดอร์ `Class.UIComponent` ตัวแก้ไขภาพ เช่น
`Class.UICorner` และ `Class.UIGradient` ที่อยู่ภายใต้ `CanvasGroup` จะนำไปใช้
กับทั้งกลุ่มทั้งหมด ข้อควรระวังว่า `CanvasGroup` จะมี
`Class.GuiObject.ClipsDescendants|ClipsDescendants` ตั้งค่าเป็น `true` และลูกหลานทั้งหมด
จะถูกเรนเดอร์ภายในพื้นที่มองของกลุ่ม

#### ข้อควรทราบที่สำคัญ

- ลูกหลานของ `CanvasGroup` จะถูกเรนเดอร์เป็นเท็กเจอร์แบบแบนเท่านั้น
  เมื่อบรรพบุรุษ `Class.LayerCollector` มี
  `Class.LayerCollector.ZIndexBehavior|ZIndexBehavior` ตั้งค่าเป็น
  `Enum.ZIndexBehavior.Sibling`.
- `CanvasGroup` ใช้หน่วยความจำเท็กเจอร์เพิ่มเติม คุณภาพของเท็กเจอร์และ
  การใช้งานหน่วยความจำรวมถูกจำกัดโดย `Enum.QualityLevel` ของไคลเอนต์ เมื่อ
  เกินขีดจำกัดหน่วยความจำ `CanvasGroup` จะทำการเรนเดอร์เป็นเท็กเจอร์สีขาว.
- แนะนำให้ใช้ `CanvasGroup` กับขนาดคงที่ มิฉะนั้นจะต้องสร้าง
  เท็กเจอร์ใหม่เพื่อตอบสนองขนาดใหม่.


CanvasGroup

สีที่ใช้กับลูกหลานทั้งหมด。

CanvasGroup.GroupColor3

ความโปร่งใสที่ใช้กับลูกหลานทั้งหมด。

CanvasGroup.GroupTransparency

ผสมลูกหลานเป็นกลุ่มด้วยสี/ความโปร่งใส。

`Class.GuiObject` เป็นคลาสนามกว้าง (คล้ายกับ `Class.BasePart`) สำหรับออบเจ็กต์ส่วนต่อประสานผู้ใช้แบบ 2D
 มันกำหนดคุณสมบัติทั้งหมดที่เกี่ยวข้องกับการแสดงผลของออบเจ็กต์ส่วนต่อประสานผู้ใช้กราฟิก (GUI) เช่น `Class.GuiObject.Size|Size`
 และ `Class.GuiObject.Position|Position`. นอกจากนี้ยังมีคุณสมบัติที่มีประโยชน์แบบอ่านได้เพียงอย่างเดียว เช่น `Class.GuiObject.AbsolutePosition|AbsolutePosition`,
`Class.GuiObject.AbsoluteSize|AbsoluteSize`, และ
`Class.GuiObject.AbsoluteRotation|AbsoluteRotation`.

ในการจัดการเลย์เอาท์ของออบเจ็กต์ GUI ในรูปแบบพิเศษ คุณสามารถใช้โครงสร้างเลย์เอาท์เช่น [list/flex](/ui/list-flex-layouts) หรือ
[grid](/ui/grid-table-layouts), และคุณสามารถกำหนดสไตล์ให้พวกเขานอกเหนือจากคุณสมบัติหลักของพวกเขาผ่าน
[appearance modifiers](/ui/appearance-modifiers).

แม้ว่าจะเป็นไปได้ที่จะตรวจจับเหตุการณ์ปุ่มเมาส์บนออบเจ็กต์ GUI ใด ๆ โดยใช้
`Class.GuiObject.InputBegan|InputBegan` และ
`Class.GuiObject.InputEnded|InputEnded`, แต่มีเพียง `Class.ImageButton` และ
`Class.TextButton` ที่มีเหตุการณ์ที่สะดวกสบายเฉพาะเช่น
`Class.TextButton.Activated|Activated` เพื่อใช้ตรวจจับการคลิก/กด.

ตัวอย่างด้านล่างถือว่าสิ่งนี้อยู่ภายใน GuiObject เช่น `TextButton` และ
คุณสมบัติ `Class.GuiObject.Draggable` ถูกตั้งค่าเป็น true มันจะพิมพ์
UDim2 ของตำแหน่งที่ผู้เล่นเริ่มต้นการลากวัตถุ

เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้เล่นเริ่มลากวัตถุ.

ดูเพิ่มเติมที่ `Class.GuiObject.DragStopped`.

GuiObject.DragBegin

initialPosition

ค่าของ `Datatype.UDim2` ตำแหน่งของ `Class.GuiObject` ก่อนการดำเนินการลากใด ๆ ที่เริ่มต้น.

เกิดขึ้นเมื่อผู้เล่นเริ่มลากวัตถุ.

ตัวอย่างด้านล่างสมมุติว่ามันอยู่ภายใน GuiObject เช่น `TextButton` และ
ว่า `Class.GuiObject.Draggable` ถูกตั้งค่าเป็น true มันจะแสดง
the X และ Y ของตำแหน่งที่ผู้เล่นหยุดการลาก GUI หากผู้เล่นหยุด
ลากวัตถุที่ตำแหน่ง 189, 180 ข้อความด้านล่างจะแสดงว่า ผู้เล่นหยุด
ลาก GuiObject ที่ (189, 180)

เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้เล่นหยุดลากวัตถุ.

ดูเพิ่มเติมที่ `Class.GuiObject.DragBegin`.

GuiObject.DragStopped

ตำแหน่ง **X** ของเมาส์ในพิกเซล, เทียบกับมุมซ้ายบนของหน้าจอ.

ตำแหน่ง **Y** ของเมาส์ในพิกเซล, เทียบกับมุมซ้ายบนของหน้าจอ.

เกิดขึ้นเมื่อผู้เล่นหยุดลากวัตถุ.

ตัวอย่างต่อไปนี้แสดงหนึ่งในหลายตัวอย่างการใช้งานในการจัดการการป้อนข้อมูลของผู้ใช้
จาก InputBegan ขึ้นอยู่กับประเภท

เพื่อให้สิ่งนี้ทำงานตามที่คาดไว้ มันต้องถูกวางใน `LocalScript`
และเป็นลูกของ _gui_.

เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้ใช้เริ่มมีปฏิสัมพันธ์กับ `Class.GuiObject` ผ่านอุปกรณ์ Human-Computer Interface (กดปุ่มเมาส์, เริ่มสัมผัส,
กดปุ่มแป้นพิมพ์, เป็นต้น).

`Class.UserInputService` มีเหตุการณ์ที่มีชื่อคล้ายกันซึ่งไม่จำกัดเฉพาะออบเจ็กต์ UI: `Class.UserInputService.InputBegan`.

เหตุการณ์นี้จะเกิดขึ้นเสมอไม่ว่าจะอยู่ในสถานะเกมใด.

ดูเพิ่มเติมที่ `Class.GuiObject.InputEnded` และ `Class.GuiObject.InputChanged`.

GuiObject.InputBegan

input

ออบเจ็กต์ `Class.InputObject` ซึ่งประกอบไปด้วยข้อมูลที่มีประโยชน์สำหรับการค้นหาข้อมูลการป้อนจากผู้ใช้ เช่น `Enum.UserInputType|ประเภทของการป้อน`, `Enum.UserInputState|สถานะของการป้อน`, และ `Class.InputObject.Position|พิกัดหน้าจอของการป้อน`。

เกิดขึ้นเมื่อผู้ใช้เริ่มมีปฏิสัมพันธ์ผ่านอุปกรณ์ Human-Computer Interface (กดปุ่มเมาส์, เริ่มสัมผัส, กดปุ่มแป้นพิมพ์, เป็นต้น).

ตัวอย่างต่อไปนี้แสดงให้เห็นหนึ่งในหลายวิธีการใช้งานของการจัดการการ
ป้อนข้อมูลจาก InputChanged ขึ้นอยู่กับประเภทของมัน。

เพื่อให้ทำงานได้ตามที่คาดหวัง มันต้องถูกวางใน `LocalScript`
และเป็นลูกของ _gui_.

เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้ใช้เปลี่ยนแปลงวิธีการที่พวกเขากำลังมีปฏิสัมพันธ์ผ่านอุปกรณ์ Human-Computer Interface (กดปุ่มเมาส์, เริ่มสัมผัส, กดปุ่มแป้นพิมพ์, เป็นต้น).

`Class.UserInputService` มีเหตุการณ์ที่มีชื่อคล้ายกันซึ่งไม่จำกัดเฉพาะออบเจ็กต์ UI:
`Class.UserInputService.InputChanged`.

เหตุการณ์นี้จะเกิดขึ้นเสมอไม่ว่าจะอยู่ในสถานะเกมใด.

ดูเพิ่มเติมที่ `Class.GuiObject.InputBegan` และ `Class.GuiObject.InputEnded`.

GuiObject.InputChanged

เกิดขึ้นเมื่อผู้ใช้เปลี่ยนแปลงวิธีการที่พวกเขากำลังมีปฏิสัมพันธ์ผ่านอุปกรณ์ Human-Computer Interface (กดปุ่มเมาส์, เริ่มสัมผัส, กดปุ่มแป้นพิมพ์, เป็นต้น).

ตัวอย่างต่อไปนี้แสดงตัวอย่างการใช้งานหลายประการในการจัดการกับอินพุตของผู้ใช้
จาก InputEnded ขึ้นอยู่กับประเภทของมัน

เพื่อให้สิ่งนี้ทำงานได้ตามที่คาดหวัง จะต้องอยู่ใน `LocalScript`
และเป็นลูกของ _gui_.

เหตุการณ์ InputEnded จะเกิดขึ้นเมื่อผู้ใช้หยุดมีปฏิสัมพันธ์ผ่านอุปกรณ์ Human-Computer Interface (กดปุ่มเมาส์, เริ่มสัมผัส, กดปุ่มแป้นพิมพ์, เป็นต้น).

`Class.UserInputService` มีเหตุการณ์ที่มีชื่อคล้ายกันซึ่งไม่จำกัดเฉพาะออบเจ็กต์ UI: `Class.UserInputService.InputEnded`.

เหตุการณ์นี้จะเกิดขึ้นเสมอไม่ว่าจะอยู่ในสถานะเกมใด.

ดูเพิ่มเติมที่ `Class.GuiObject.InputBegan` และ `Class.GuiObject.InputChanged`.

GuiObject.InputEnded

ออบเจ็กต์ `Class.InputObject` ซึ่งประกอบไปด้วยข้อมูลที่มีประโยชน์สำหรับการค้นหาข้อมูลการป้อนจากผู้ใช้ เช่น `Enum.UserInputType`, `Enum.UserInputState`, และ `Class.InputObject.Position`。

เกิดขึ้นเมื่อผู้ใช้หยุดมีปฏิสัมพันธ์ผ่านอุปกรณ์ Human-Computer Interface (กดปุ่มเมาส์, เริ่มสัมผัส, กดปุ่มแป้นพิมพ์, เป็นต้น).

ตัวอย่างต่อไปนี้จะแสดงตำแหน่งของเมาส์เป็นพิกเซลเมื่อมันเข้ามาใน GUI
องค์ประกอบ.

เหตุการณ์ MouseEnter จะเกิดขึ้นเมื่อผู้ใช้เคลื่อนเมาส์เข้าไปใน
`Class.GuiObject`.

กรุณาอย่าอิงกับอาร์กิวเมนต์ `x` และ `y` ที่ส่งโดยเหตุการณ์นี้ว่าเป็นวิธีการที่สมบูรณ์ในการกำหนดว่าเมาส์ของผู้ใช้อยู่ที่ใดเมื่อมันเข้าไปใน GUI. พิกัดเหล่านี้อาจแตกต่างกันแม้ว่าจะมีการเข้าสู่ GUI ผ่านขอบเดียวกัน - โดยเฉพาะเมื่อเมาส์เคลื่อนที่เข้าไปในองค์ประกอบอย่างรวดเร็ว. นี่เป็นเพราะว่าพิกัดจะระบุถึงตำแหน่งของเมาส์เมื่อเหตุการณ์เกิดขึ้น rather than the exact moment the mouse enters the GUI.

เหตุการณ์นี้เกิดขึ้นแม้ว่าองค์ประกอบ GUI จะแสดงอยู่ใต้กระดาษอื่น.

ถ้าคุณต้องการติดตามเมื่อเมาส์ของผู้ใช้ออกจากองค์ประกอบ GUI, คุณสามารถใช้เหตุการณ์ `Class.GuiObject.MouseLeave`.

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

- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelForward`
- `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseEnter

พิกัด **X** ของเมาส์ในพิกเซล, เทียบกับมุมซ้ายบนของหน้าจอ.

พิกัด **Y** ของเมาส์ในพิกเซล, เทียบกับมุมซ้ายบนของหน้าจอ.

เกิดขึ้นเมื่อผู้ใช้ใช้เมาส์เคลื่อนตัวไปยังออบเจ็กต์ GUI.

เหตุการณ์ MouseLeave จะเกิดขึ้นเมื่อผู้ใช้เคลื่อนเมาส์ออกจาก
`Class.GuiObject`.

กรุณาอย่าอิงกับอาร์กิวเมนต์ `x` และ `y` ที่ส่งโดยเหตุการณ์นี้ว่าเป็นวิธีการที่สมบูรณ์ในการกำหนดว่าเมาส์ของผู้ใช้อยู่ที่ใดเมื่อออกจาก GUI. พิกัดเหล่านี้อาจแตกต่างกันแม้ว่าจะมีการออกจาก GUI ผ่านขอบเดียวกัน - โดยเฉพาะเมื่อเมาส์เคลื่อนที่ออกจากองค์ประกอบอย่างรวดเร็ว. นี่เป็นเพราะว่าพิกัดจะระบุถึงตำแหน่งของเมาส์เมื่อเหตุการณ์เกิดขึ้น rather than the exact moment the mouse leaves the GUI.

เหตุการณ์นี้เกิดขึ้นแม้ว่าองค์ประกอบ GUI จะถูกแสดงอยู่ใต้กระดาษอื่น.

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

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelForward`
- `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseLeave

เกิดขึ้นเมื่อผู้ใช้เคลื่อนเมาส์ออกจากออบเจ็กต์ GUI.

เกิดขึ้นเมื่อผู้ใช้เคลื่อนเมาส์ในขณะที่อยู่ภายใน
`Class.GuiObject` ออก. คล้ายกับ `Class.Mouse.Move`, ที่เกิดขึ้นไม่ว่าคุณจะอยู่เหนือออบเจ็กต์ GUI หรือไม่.

หมายเหตุ, เหตุการณ์นี้เกิดขึ้นเมื่ออัตราส่วนของเมาส์ได้รับการอัปเดต, ดังนั้นมันจึงเกิดขึ้นซ้ำ ๆ ขณะถูกเคลื่อนที่.

อาร์กิวเมนต์ `x` และ `y` จะบอกพิกัดหน้าจอที่อัปเดตของเมาส์ในพิกเซล. สิ่งเหล่านี้สามารถมีประโยชน์ในการกำหนดตำแหน่งของเมาส์บน GUI, หน้าจอ, และความต่างตั้งแต่พิกัดก่อนหน้าของเมาส์หากถูกติดตามในตัวแปรทั่วโลก.

โค้ดต่อไปนี้แสดงให้เห็นถึงวิธีการกำหนดความฉลาด `Datatype.Vector2` ของเมาส์ของผู้ใช้เองเทียบกับออบเจ็กต์ GUI:

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

local CustomScrollingFrame = script.Parent
local SubFrame = CustomScrollingFrame:FindFirstChild("SubFrame")

local mouse = Players.LocalPlayer:GetMouse()

local function getPosition(X, Y)
	local gui_X = CustomScrollingFrame.AbsolutePosition.X
	local gui_Y = CustomScrollingFrame.AbsolutePosition.Y


	local pos = Vector2.new(math.abs(X - gui_X), math.abs(Y - gui_Y - 36))
	print(pos)
end

CustomScrollingFrame.MouseMoved:Connect(getPosition)
```
หมายเหตุว่าเหตุการณ์นี้อาจไม่เกิดขึ้นแต่ละเมื่อเมาส์ของผู้ใช้เข้าสู่องค์ประกอบ GUI. ดังนั้น, อาร์กิวเมนต์ `x` และ `y` อาจไม่ตรงกับพิกัดของขอบ GUI.

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

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseWheelForward`
- `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseMoved

เกิดขึ้นเมื่อผู้ใช้เคลื่อนเมาส์ในขณะที่อยู่ภายในออบเจ็กต์ GUI.

เหตุการณ์ WheelBackward จะเกิดขึ้นเมื่อผู้ใช้เลื่อนเมาส์ย้อนกลับขณะเมาส์อยู่เหนือ
`Class.GuiObject` องค์ประกอบ. คล้ายกับ `Class.Mouse.WheelBackward`, ซึ่งเกิดขึ้นไม่ว่าคุณจะอยู่เหนือองค์ประกอบ GUI หรือไม่.

เหตุการณ์นี้เกิดขึ้นเพียงเพื่อชี้แจงการเคลื่อนไหวของล้อย้อนกลับ. นี่หมายความว่าพิกัดเมาส์ **X** และ **Y** จะไม่เปลี่ยนแปลงผลจากเหตุการณ์นี้. พิกัดเหล่านี้จะเปลี่ยนแปลงเมื่อเมาส์เคลื่อนที่, ซึ่งสามารถติดตามได้จากเหตุการณ์ `Class.GuiObject.MouseMoved`.

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

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelForward`

GuiObject.MouseWheelBackward

เกิดขึ้นเมื่อผู้ใช้เลื่อนเมาส์ย้อนกลับขณะที่เมาส์อยู่เหนือองค์ประกอบ GUI.

เหตุการณ์ WheelForward จะเกิดขึ้นเมื่อผู้ใช้เลื่อนเมาส์ไปข้างหน้าขณะเมาส์อยู่เหนือ
`Class.GuiObject` องค์ประกอบ. คล้ายกับ `Class.Mouse.WheelForward`, ซึ่งเกิดขึ้นไม่ว่าคุณจะอยู่เหนือองค์ประกอบ GUI หรือไม่.

เหตุการณ์นี้เกิดขึ้นเพียงเพื่อชี้แจงการเคลื่อนไหวของล้อไปข้างหน้า. นี่หมายความว่าพิกัดเมาส์ **X** และ **Y** จะไม่เปลี่ยนแปลงผลจากเหตุการณ์นี้. พิกัดเหล่านี้จะเปลี่ยนแปลงเมื่อเมาส์เคลื่อนที่, ซึ่งสามารถติดตามได้จากเหตุการณ์ `Class.GuiObject.MouseMoved`.

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

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseWheelForward

เกิดขึ้นเมื่อผู้ใช้เลื่อนเมาส์ไปข้างหน้าเมื่อเมาส์อยู่เหนือองค์ประกอบ GUI.

ตัวอย่างด้านล่างนี้จะแสดงข้อความเมื่อผู้ใช้เลือกวัตถุด้วย
เกมแพด。

เพื่อให้ทำงานได้ตามที่คาดหวัง มันต้องอยู่ใน `LocalScript`
และเป็นลูกของ _gui_。


เหตุการณ์นี้เกิดขึ้นเมื่อการเลือก Gamepad เริ่มมุ่งเน้นไปที่
`Class.GuiObject`。

หากคุณต้องการตรวจสอบเมื่อการเลือกของ Gamepad หยุดมุ่งเน้นไปที่
element GUI คุณสามารถใช้เหตุการณ์ `Class.GuiObject.SelectionLost`。

เมื่อ GUI ได้รับโฟกัสในการเลือก ค่าของ
`Class.GuiService.SelectedObject|SelectedObject` จะเปลี่ยนเพื่อให้ตรงกับ
สิ่งที่ได้รับการเลือก ตเพื่อตรวจสอบว่า GUI ใดได้รับการเลือก ให้ตรวจสอบ
ค่าของคุณสมบัตินี้。

GuiObject.SelectionGained

เกิดขึ้นเมื่อ GuiObject ถูกมุ่งเน้นไปที่ผู้เลือกเกมแพด.

ตัวอย่างต่อไปนี้จะแสดงข้อความเมื่อองค์ประกอบสูญเสียโฟกัสบน
เกมแพด.

เพื่อให้สิ่งนี้ทำงานตามที่คาดไว้ มันต้องถูกวางใน `LocalScript`
และเป็นลูกของ _gui_.

เหตุการณ์นี้เกิดขึ้นเมื่อการเลือก Gamepad หยุดมุ่งเน้นไปที่
`Class.GuiObject`。

หากคุณต้องการตรวจสอบเมื่อการเลือกของ Gamepad เริ่มมุ่งเน้นไปที่
element GUI คุณสามารถใช้เหตุการณ์ `Class.GuiObject.SelectionGained`。

เมื่อ GUI สูญเสียโฟกัสในการเลือก ค่าของ
`Class.GuiService.SelectionObject|SelectionObject` จะเปลี่ยนเป็น `nil` หรือ
ไปยัง element GUI ที่ได้รับโฟกัสในการเลือก เพื่อตรวจสอบว่า GUI ใดได้รับการเลือก,
หรือหากไม่มีก็ให้เช็คค่าของคุณสมบัตินี้。

GuiObject.SelectionLost

เกิดขึ้นเมื่อการเลือก Gamepad หยุดมุ่งเน้นไปที่ GuiObject。

ตัวอย่างโค้ดนี้อนุญาตให้ผู้เล่นจัดการตำแหน่งบนหน้าจอของบาง
UI element เช่น `Frame` โดยการกดค้างที่ UI element เป็นเวลาสั้น ๆ
จากนั้นผู้เล่นจะขยับนิ้วและปล่อย ในระหว่างการเคลื่อนไหวนั้น
Frame จะถูกทำให้เป็นสีน้ำเงินด้วยกรอบสีขาว.

เหตุการณ์นี้จะเกิดขึ้นหลังจากช่วงเวลาสั้น ๆ เมื่อผู้เล่นกดนิ้วของพวกเขา
บนองค์ประกอบ UI โดยใช้อุปกรณ์ที่รองรับการสัมผัส จะเกิดขึ้นพร้อมกับตารางของ
`Datatype.Vector2` ที่อธิบายตำแหน่งหน้าจอสัมพัทธ์ของ
นิ้วที่เกี่ยวข้องในท่าทางนี้ นอกจากนี้ยังเกิดขึ้นหลายครั้ง:
`Enum.UserInputState.Begin` หลังจากดีเลย์สั้น ๆ,
`Enum.UserInputState.Change` หากผู้เล่นขยับนิ้วของพวกเขาระหว่าง
the gesture, และสุดท้าย `Enum.UserInputState.End` ดีเลย์ขึ้นอยู่กับแพลตฟอร์ม;
ใน Studio จะนานกว่าหนึ่งวินาทีเล็กน้อย.

GuiObject.TouchLongPress

touchPositions

อาเรย์ของ `Datatype.Vector2` ที่อธิบายตำแหน่ง **สัมพัทธ์**
ของนิ้วที่เกี่ยวข้องในท่าทาง。

state

ค่าของ `Enum.UserInputState` ที่อธิบายสถานะของการเคลื่อนไหว:

- Begin จะเกิดขึ้นครั้งเดียวที่จุดเริ่มต้นของท่าทาง (หลังจากที่มีการ
  ชะลอครู่หนึ่ง)
- Change จะเกิดขึ้นหากผู้เล่นขยับนิ้วขณะกดลง
- End จะเกิดขึ้นครั้งเดียวที่จุดสิ้นสุดของท่าทางเมื่อผู้เล่นปล่อยนิ้วของพวกเขา。

เกิดขึ้นเมื่อผู้เล่นเริ่ม, ดำเนินการ และหยุดการกดค้างที่ UI
element。

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

เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้เล่นขยับนิ้วของพวกเขาบนองค์ประกอบ UI
โดยใช้อุปกรณ์ที่รองรับการสัมผัส จะเกิดขึ้นก่อน
`Class.GuiObject.TouchSwipe` และจะไม่เกิดขึ้นพร้อมกับ
`Class.GuiObject.TouchTap` เหตุการณ์นี้มีประโยชน์สำหรับการให้ผู้เล่น
สามารถจัดการตำแหน่งขององค์ประกอบ UI บนหน้าจอ.

เหตุการณ์นี้จะเกิดขึ้นพร้อมกับตารางของ `Datatype.Vector2` ที่อธิบาย
ตำแหน่งหน้าจอสัมพัทธ์ของนิ้วที่เกี่ยวข้องในท่าทาง นอกจากนี้ยังเกิดขึ้นหลายครั้ง:
`Enum.UserInputState.Begin` หลังจากดีเลย์สั้น ๆ,
`Enum.UserInputState.Change` เมื่อผู้เล่นขยับนิ้วของพวกเขา
ระหว่างท่าทาง, และสุดท้ายจะเกิดขึ้นพร้อมกับ `Enum.UserInputState.End`.

GuiObject.TouchPan

อาเรย์ของ `Datatype.Vector2` ที่แต่ละอันระบุถึงตำแหน่งของ
นิ้วทุกอันที่เกี่ยวข้องในท่าทาง。

totalTranslation

ระบุถึงว่าการเคลื่อนไหวในท่าทางได้นำไปสู่ที่จุดเริ่มต้นเท่าใด。

velocity

ระบุถึงความเร็วของการเคลื่อนไหวในแต่ละ
มิติ。

ระบุถึง `Enum.UserInputState` ของท่าทาง。

เกิดขึ้นเมื่อผู้เล่นเคลื่อนนิ้วของพวกเขาบน UI element。

ตัวอย่างโค้ดนี้มีไว้สำหรับ `LocalScript` ภายใน `Frame` ที่อยู่
ใน `Frame` ภายนอก หรือ `GuiObject` อื่น ๆ โดยอนุญาตให้ผู้เล่นสามารถปรับขนาด
กรอบภายในได้โดยการทำท่าทาง `Class.GuiObject.TouchPinch` บน
กรอบภายนอก.

เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้เล่นใช้สองนิ้วในการทำท่าทางการบีบหรือดึง
โดยใช้องค์ประกอบ UI ที่รองรับการสัมผัส **การบีบ**
เกิดขึ้นเมื่อสองนิ้วหรือมากกว่าขยับเข้ามาใกล้กัน และ **การดึง**
เกิดขึ้นเมื่อพวกเขาขยับออกจากกัน เหตุการณ์นี้จะเกิดขึ้นพร้อมกับ
`Class.GuiObject.TouchPan` เหตุการณ์นี้มีประโยชน์สำหรับการให้ผู้เล่น
สามารถจัดการขนาด (มาตราส่วน) ขององค์ประกอบ UI บนหน้าจอ และมักใช้
สำหรับฟีเจอร์ที่ทำการซูม.

เหตุการณ์นี้จะเกิดขึ้นพร้อมกับตารางของ `Datatype.Vector2` ที่อธิบาย
ตำแหน่งหน้าจอสัมพัทธ์ของนิ้วที่เกี่ยวข้องในท่าทาง นอกจากนี้ยังเกิดขึ้นหลายครั้ง:
`Enum.UserInputState.Begin` หลังจากดีเลย์สั้น ๆ,
`Enum.UserInputState.Change` เมื่อผู้เล่นขยับนิ้ว
during the gesture และสุดท้ายจะเกิดขึ้นพร้อมกับ `Enum.UserInputState.End` ควร
สังเกตว่าขนาดควรใช้ **แบบการคูณ**.

GuiObject.TouchPinch

อาเรย์ของ `Datatype.Vector2` ที่แต่ละอันระบุถึงตำแหน่งของ
นิ้วทุกอันที่เกี่ยวข้องในท่าทางการบีบ。

scale

ค่าลอยที่ระบุถึงความแตกต่างตั้งแต่ต้นท่าทางการบีบ。

ค่าลอยที่ระบุถึงความเร็วของการบีบท่าทาง。

เกิดขึ้นเมื่อผู้เล่นทำท่าทางการบีบหรือดึงโดยใช้สองนิ้ว
บน UI element。

ตัวอย่างโค้ดนี้มีไว้สำหรับ `LocalScript` ภายใน `Frame` ที่อยู่
ภายใน `Frame` ภายนอก หรือ `GuiObject` อื่น ๆ มันอนุญาตให้ผู้เล่นหมุน
กรอบภายในโดยการทำการเคลื่อนไหว `Class.GuiObject.TouchRotate` บน
กรอบภายนอก.

เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้เล่นใช้สองนิ้วในการทำท่าทางการบีบหรือดึง
โดยใช้องค์ประกอบ UI ที่รองรับการสัมผัส การหมุนจะเกิดขึ้น
เมื่อมุมระหว่างเส้นที่เชื่อมระหว่างนิ้วสองนิ้วเปลี่ยนไป เหตุการณ์นี้จะเกิดขึ้น
พร้อมกับ `Class.GuiObject.TouchPan` เหตุการณ์นี้มีประโยชน์สำหรับ
การให้ผู้เล่นสามารถจัดการการหมุนขององค์ประกอบ UI บนหน้าจอ.

เหตุการณ์นี้จะเกิดขึ้นพร้อมกับตารางของ `Datatype.Vector2` ที่อธิบาย
ตำแหน่งหน้าจอสัมพัทธ์ของนิ้วที่เกี่ยวข้องในท่าทาง นอกจากนี้ยังเกิดขึ้นหลายครั้ง:
`Enum.UserInputState.Begin` หลังจากดีเลย์สั้น ๆ,
`Enum.UserInputState.Change` เมื่อผู้เล่นขยับนิ้ว
during the gesture และสุดท้ายจะเกิดขึ้นพร้อมกับ `Enum.UserInputState.End`.

GuiObject.TouchRotate

rotation

ค่าลอยที่ระบุว่าการหมุนเกิดขึ้นจากจุดเริ่มต้นของ
การเคลื่อนไหวเท่าใด。

ค่าลอยที่ระบุถึงความเร็วของการเคลื่อนไหวที่เกิดขึ้น。

เกิดขึ้นเมื่อผู้เล่นทำท่าทางการหมุนโดยใช้สองนิ้วบน
UI element。

ตัวอย่างโค้ดนี้จะทำให้ `Frame` (หรือ `GuiObject` อื่น ๆ) เด้งเมื่อมีการ
ทำท่าหรือการเลื่อนบนอุปกรณ์ที่รองรับการสัมผัส (หรืออีมูเลเตอร์ของ Studio).
การเลื่อนในแนวนอนจะเปลี่ยนเฉดสีของ `Class.GuiObject.BackgroundColor3`, ขณะที่การเลื่อนในแนวตั้งจะเปลี่ยน
ความอิ่มตัว.

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

GuiObject.TouchSwipe

swipeDirection

ค่าของ `Enum.SwipeDirection` ที่ระบุถึงทิศทางของการเช็ด
(ขึ้น, ลง, ซ้าย หรือ ขวา)。

numberOfTouches

จำนวนจุดสัมผัสที่เกี่ยวข้องในท่าทาง (โดยปกติคือ 1)。

เกิดขึ้นเมื่อผู้เล่นทำท่าทางการเช็ดบน UI element。

ตัวอย่างโค้ดนี้จะสลับ `Class.GuiObject.BackgroundTransparency` ของ
UI element เช่น `Frame` เมื่อมันถูกสัมผัสบนอุปกรณ์ที่รองรับการสัมผัส.

เหตุการณ์นี้จะเกิดขึ้นเมื่อผู้เล่นทำนิ้วแตะบนองค์ประกอบ UI
โดยใช้อุปกรณ์ที่รองรับการสัมผัส การแตะคือการสัมผัสอย่างรวดเร็วเพียงครั้งเดียวโดยไม่มี
การขยับใด ๆ (การกดนานจะเกิดขึ้น
`Class.GuiObject.TouchLongPress`, และการขยับระหว่างการแตะจะเกิดขึ้น
`Class.GuiObject.TouchPan` และ/หรือ `Class.GuiObject.TouchSwipe`) จะเกิดขึ้น
พร้อมกับตารางของ `Datatype.Vector2` ที่อธิบายตำแหน่งสัมพัทธ์ของ
นิ้วที่เกี่ยวข้องในท่าทาง.

GuiObject.TouchTap

เกิดขึ้นเมื่อผู้เล่นทำท่าทางการแตะบน UI element。

ตัวอย่างโค้ดนี้แสดงการใช้งาน TweenPosition ที่ซับซ้อนมากขึ้นโดย
การตรวจจับเมื่อการเคลื่อนที่เสร็จสิ้น/ถูกยกเลิกโดยการกำหนดฟังก์ชัน callback มัน
ยังพิมพ์ว่าการเคลื่อนที่นั้นจะเล่นหรือไม่

เคลื่อน GUI ไปยังตำแหน่ง `Datatype.UDim2` ใหม่อย่างราบรื่นในเวลาที่กำหนดโดยใช้ `Enum.EasingDirection` และ `Enum.EasingStyle` ที่กำหนด.

ฟังก์ชันนี้จะคืนค่าผลว่าทางเกินนี้จะเล่นหรือไม่. จะไม่เล่นหากมีทางเกินอีกทางกำลังดำเนินการอยู่และพารามิเตอร์การเขียนทับเป็น `false`.

ดูเพิ่มเติมที่ `Class.GuiObject:TweenSize()` และ
`Class.GuiObject:TweenSizeAndPosition()`.

GuiObject:TweenPosition

endPosition

ตำแหน่งที่ GUI ควรจะย้ายไป.

easingDirection

ทิศทางที่จะแก้ไข GUI ไปยัง _endPosition_.

easingStyle

สไตล์ที่จะแก้ไข GUI ไปยัง _endPosition_.

time

ระยะเวลาที่, เป็นวินาที, ทางเกินควรใช้เวลาทำให้เสร็จ.

override

ว่าจะมีการเขียนทับทางเกินที่กำลังดำเนินการอยู่หรือไม่.

callback

ฟังก์ชัน callback ที่จะดำเนินการเมื่อทางเกินเสร็จสิ้น.

ว่าจะเล่นทางเกินหรือไม่.

เคลื่อน GUI ไปยัง `Datatype.UDim2` ใหม่อย่างราบรื่น.

ตัวอย่างโค้ดนี้แสดงการใช้ฟังก์ชัน `Class.GuiObject:TweenSize()`
มันเริ่มต้นการเคลื่อนไหวในคุณสมบัติ `Class.GuiObject.Size` ของพ่อแม่
ไปยัง `UDim2.new(0.5, 0, 0.5, 0)` ซึ่งเป็นครึ่งหนึ่งของขนาด `GuiObject`
ของพ่อแม่ในทั้งสองแกน

นอกจากนี้ยังแสดงให้เห็นว่าพารามิเตอร์ callback สามารถใช้เพื่อตรวจจับ
เมื่อการเคลื่อนไหวหยุดลง (ไม่ว่ามันจะถูกยกเลิกโดยการเคลื่อนไหวอื่นหรือเสร็จสิ้น).

ปรับขนาด `Class.GuiObject` ไปยัง `Datatype.UDim2` ใหม่อย่างราบรื่นในเวลาที่กำหนดโดยใช้ `Enum.EasingDirection`
และ `Enum.EasingStyle` ที่กำหนด.

ฟังก์ชันนี้จะคืนค่าผลว่าทางเกินนี้จะเล่นหรือไม่. โดยทั่วไปจะคืนค่า `true` เสมอ, แต่จะคืนค่า `false` หากมีทางเกินอื่นกำลังอยู่ และ `override` ตั้งไว้เป็น `false`.

ดูเพิ่มเติมที่ `Class.GuiObject:TweenSize()` และ
`Class.GuiObject:TweenSizeAndPosition()`.

GuiObject:TweenSize

endSize

ขนาดที่ GUI ควรเปลี่ยนขนาด.

ทิศทางที่จะแก้ไข GUI ไปยัง _endSize_.

สไตล์ที่จะแก้ไข GUI ไปยัง _endSize_.

ปรับขนาด `Class.GuiObject` ไปยัง `Datatype.UDim2` ใหม่อย่างราบรื่น.

ตัวอย่างด้านล่างจะเปลี่ยนขนาดของ `Class.Frame` ไปที่มุมซ้ายบนของขนาดของพ่อ
และปรับขนาดมันลงเป็น 0.

ปรับขนาดและเคลื่อน GUI ไปยังขนาดและตำแหน่งใหม่ `Datatype.UDim2` อย่างราบรื่นในเวลาที่กำหนดโดยใช้ `Enum.EasingDirection`
และ `Enum.EasingStyle` ที่กำหนด.

ฟังก์ชันนี้จะคืนค่าผลว่าทางเกินนี้จะเล่นหรือไม่. โดยทั่วไปจะคืนค่า `true` เสมอ, แต่จะคืนค่า `false` หากมีทางเกินอื่นกำลังอยู่ และ `override` ตั้งไว้เป็น `false`.

ดูเพิ่มเติมที่ `Class.GuiObject:TweenSize()` และ
`Class.GuiObject:TweenSizeAndPosition()`.

GuiObject:TweenSizeAndPosition

ทิศทางที่จะทำให้ GUI ไปยัง _endSize_ และ _endPosition_.

สไตล์ที่จะแก้ไข GUI ไปยัง _endSize_ และ _endPosition_.

ปรับขนาดและเคลื่อน GUI ไปยังขนาดและตำแหน่งใหม่อย่างราบรื่น.

GuiObject

ตัวอย่างโค้ดนี้แสดงการใช้งานของคุณสมบัติ Active เป็นการดีบาวน์
สำหรับอีเวนต์ Activated.

คุณสมบัตินี้กำหนดว่าคุณสมบัติ `Class.GuiObject` จะรับข้อมูลเข้าสำหรับพื้นที่ 3 มิติหรือไม่ เช่น โมเดลที่อยู่เบื้องหลังที่มีคลาส `Class.ClickDetector` เช่น `Class.DragDetector`.

สำหรับออบเจ็กต์ `Class.GuiButton` (`Class.ImageButton` และ
`Class.TextButton`), คุณสมบัตินี้กำหนดว่าคุณสมบัติ `Class.GuiButton.Activated|Activated` จะถูกเรียกใช้หรือไม่
(`Class.GuiButton.AutoButtonColor|AutoButtonColor` จะยังคงทำงานได้สำหรับเหล่านั้นด้วย). เหตุการณ์ `Class.GuiObject.InputBegan|InputBegan`,
`Class.GuiObject.InputChanged|InputChanged`, และ
`Class.GuiObject.InputEnded|InputEnded` จะทำงานตามปกติไม่ว่าจะมีมูลค่าของคุณสมบัตินี้อย่างไร.

GuiObject.Active

กำหนดว่าจุดนี้เป็นเอ็นที่รับข้อมูลหรือไม่.

ตัวอย่างโค้ดนี้จะย้ายองค์ประกอบ UI ไปยังด้านต่างๆ ขององค์ประกอบหลัก。
เริ่มจากมุมซ้ายบนและสิ้นสุดที่มุมขวาล่าง วางลงใน
LocalScript ภายใน Frame, ภายใน ScreenGui.

คุณสมบัตินี้กำหนดจุดเริ่มต้นของ `Class.GuiObject`, ซึ่งสัมพันธ์กับขนาดที่แท้จริง. จุดเริ่มต้นจะกำหนดจากที่ซึ่งออบเจ็กต์ถูกจัดวาง (ผ่าน `Class.GuiObject.Position`) และจากที่ซึ่ง `Class.GuiObject.Size` ขยายออก.

ดู [ที่นี่](/ui/position-and-size#anchorpoint) สำหรับภาพประกอบและรายละเอียด.

GuiObject.AnchorPoint

กำหนดจุดเริ่มต้นของ `Class.GuiObject` ที่เกี่ยวข้องกับขนาดสัมบูรณ์.

สคริปต์ต่อไปนี้สร้างกรอบหลักที่มีขนาดอัตโนมัติพร้อมกับ
a`UIListLayout` จากนั้นจะใส่วัตถุ `TextLabel`
หลายตัวที่มีขนาดอัตโนมัติ โปรดสังเกตว่ากรอบหลัก `UIListLayout`
จะปรับขนาดอัตโนมัติเพื่อให้พอดีกับเนื้อหาของบุตรและป้ายชื่อจะปรับขนาดอัตโนมัติเพื่อให้พอดีกับเนื้อหาข้อความของพวกเขา
สคริปต์นี้สามารถถูกนำไปเป็นบิดาใน `ScreenGui`.

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

เมื่อ `Class.GuiObject.AutomaticSize|AutomaticSize` ถูกตั้งค่าเป็นค่า `Enum.AutomaticSize` ที่ไม่เป็น
`Enum.AutomaticSize|None`, และออบเจ็กต์ UI นี้อาจปรับขนาดขึ้นอยู่กับเนื้อหาของบุตรของมัน.

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการใช้คุณสมบัตินี้และวิธีการทำงาน, โปรดดู [ที่นี่](/ui/size-modifiers#automatic-sizing).

GuiObject.AutomaticSize

กำหนดว่าจะมีการปรับขนาดตามเนื้อหาของบุตรหรือไม่.

กำหนดสีพื้นหลังของ `Class.GuiObject`.

GuiObject.BackgroundColor

ตัวอย่างโค้ดนี้ทำให้กรอบพ่อแม่หมุนผ่านสีทั้งหมดยี่สิบสี่สีของสายรุ้งโดยใช้ Color3.fromHSV.

คุณสมบัตินี้กำหนดสีพื้นหลังของ `Class.GuiObject` (สีฟิล). หากออบเจ็กต์ของคุณมีข้อความ เช่น `Class.TextBox`,
`Class.TextButton`, หรือ `Class.TextLabel`, คุณควรตรวจสอบให้แน่ใจว่าสีพื้นหลังของคุณจะตัดกันกับสีของข้อความ.

คุณสมบัติอีกอย่างหนึ่งที่กำหนดคุณสมบัติภาพของพื้นหลังคือ `Class.GuiObject.BackgroundTransparency`; หากตั้งค่าเป็น `1`,
พื้นหลังและขอบจะไม่แสดงผล.

ดูเพิ่มเติมที่ `Class.GuiObject.BorderColor3|BorderColor3`.

GuiObject.BackgroundColor3

คุณสมบัตินี้กำหนดความโปร่งใสของพื้นหลังและขอบของ `Class.GuiObject`. อย่างไรก็ตาม, จะไม่กำหนดความโปร่งใสของข้อความหาก GUI เป็น `Class.TextBox`, `Class.TextButton`, หรือ
`Class.TextLabel`; ความโปร่งใสของข้อความจะถูกกำหนดโดย `Class.TextBox.TextTransparency`, `Class.TextButton.TextTransparency`, และ
`Class.TextLabel.TextTransparency` ตามลำดับ.

หากตั้งค่านี้เป็น `1`, ไม่มีพื้นหลังหรือขอบจะถูกแสดง ไม่แสดงพื้นหลังของ GUI จะมีความโปร่งใสอย่างสมบูรณ์.

GuiObject.BackgroundTransparency

กำหนดความโปร่งใสของพื้นหลังและขอบของ `Class.GuiObject`.

กำหนดสีของขอบของ `Class.GuiObject`.

GuiObject.BorderColor

ตัวอย่างโค้ดนี้ทำให้ขอบของ GuiObject หลักไฮไลต์เมื่อผู้ใช้เลื่อนเมาส์ไปที่องค์ประกอบ.

กำหนดสีของขอบสี่เหลี่ยมของ `Class.GuiObject` (เรียกอีกอย่างว่าสีขอบ). ซึ่งจะแยกจาก `Class.GuiObject.BackgroundColor3`. คุณจะไม่สามารถมองเห็นขอบของออบเจ็กต์หากคุณสมบัติ `Class.GuiObject.BorderSizePixel` ถูกตั้งค่าเป็น `0`.

หมายเหตุว่า `Class.UIStroke` ช่วยให้สามารถสร้างเอฟเฟกต์ขอบที่มีความซับซ้อนมากขึ้น.

GuiObject.BorderColor3

กำหนดสีขอบของ `Class.GuiObject`.

คุณสมบัตินี้กำหนดวิธีจัดเรียงขอบของ `Class.GuiObject` ให้สัมพันธ์กับมิติของมัน โดยใช้ enum ที่มีชื่อเดียวกัน, `Enum.BorderMode`.

หมายเหตุว่า `Class.UIStroke` สามารถเขียนทับคุณสมบัตินี้และอนุญาตให้มีเอฟเฟกต์ขอบที่มีความก้าวหน้ามากขึ้น.

GuiObject.BorderMode

กำหนดวิธีจัดเรียงขอบของ `Class.GuiObject` ให้สัมพันธ์กับมิติของมัน.

คุณสมบัตินี้กำหนดขนาดของขอบของ `Class.GuiObject` โดยพิกเซล. หากตั้งค่านี้เป็น 0 จะไม่มีขอบเอาต์พุตเลย.

หมายเหตุว่า `Class.UIStroke` สามารถเขียนทับคุณสมบัตินี้และอนุญาตให้ใช้เอฟเฟกต์ขอบที่มีความซับซ้อนมากขึ้น.

GuiObject.BorderSizePixel

กำหนดความกว้างของขอบของ `Class.GuiObject` เป็นพิกเซล.

คุณสมบัตินี้กำหนดว่าผลที่ได้ของ `Class.GuiObject` จะตัด (ทำให้มองไม่เห็น) ส่วนใดของส่วน GUI ที่จะถูกแสดงผลซึ่งจะถูกเรียกใช้จากขอบเขตของสี่เหลี่ยม.

หมายเหตุว่า `Class.GuiObject.Rotation|Rotation` ไม่รองรับโดยคุณสมบัตินี้. หากนี้หรือออบเจ็กต์ GUI ที่เป็นบรรพบุรุษใด ๆ มี `Class.GuiObject.Rotation|Rotation` ที่ **ไม่เป็นศูนย์**, คุณสมบัตินี้จะถูก **ละเว้น** และนี่คือวัตถุ GUI ของลูกหลานจะถูกแสดงผลไม่ว่าจะมีมูลค่าของคุณสมบัตินี้หรือไม่.

GuiObject.ClipsDescendants

กำหนดว่าส่วนเชิงลึก `Class.GuiObject|GuiObjects` นอกเหนือจากขอบเขตของออบเจ็กต์ GUI ที่พวกเขาเพิ่มควรแสดงผลหรือไม่.

นี่แสดงถึงว่า `Class.GuiObject` (และบุตรของมัน) สามารถลากไปทั่วหน้าจอได้หรือไม่.

GuiObject.Draggable

กำหนดว่า `Class.GuiObject` (และบุตรของมัน) สามารถลากไปรอบๆหน้าจอได้หรือไม่.

เมื่อมือของผู้เล่นถูกแตะและกดลงที่ `Class.GuiObject`, `Class.GuiObject.GuiState|GuiState` ของ `Class.GuiObject` จะถูกตั้งค่าเป็น `Enum.GuiState.Press|Press`. ในทำนองเดียวกัน,
เมื่อมือของผู้เล่นถูกปล่อยจาก `Class.GuiObject`, `Class.GuiObject.GuiState|GuiState` ของ `Class.GuiObject` จะถูกตั้งค่าเป็น
`Enum.GuiState.Idle|Idle`, และเมื่อ `Class.GuiObject.Interactable|Interactable` ถูกปิดบน
`Class.GuiObject`, `Class.GuiState` ของ `Class.GuiObject` จะถูกตั้งค่าเป็น
`Enum.GuiState.NonInteractable|NonInteractable`.

GuiObject.GuiState

กำหนดว่ามือของผู้เล่นกำลังถูกกดลงบน `Class.GuiObject` หรือไม่.

GuiObject.InputSink

กำหนดว่าคุณสามารถโต้ตอบกับ `Class.GuiButton` ได้หรือไม่ หรือ
สถานะของ `Enum.GuiState|GuiState` ของ `Class.GuiObject` เปลี่ยนแปลงหรือไม่.

ใน `Class.GuiButton`:

- เมื่อการตั้งค่า `Class.GuiObject.Interactable|Interactable` ที่อยู่บน
  `Class.GuiButton` ถูกตั้งค่าเป็น `false` `Class.GuiButton` จะไม่
  สามารถกดหรือคลิกได้อีกต่อไป และสถานะของ
  `Class.GuiObject.GuiState|GuiState` จะถูกตั้งค่าเป็น
  `Enum.GuiState.NonInteractable|NonInteractable` อยู่เสมอ.
- เมื่อการตั้งค่า `Class.GuiObject.Interactable|Interactable` ที่อยู่บน
  `Class.GuiButton` ถูกตั้งค่าเป็น `true` `Class.GuiButton` จะทำงาน
  ตามปกติอีกครั้งและสถานะของ `Class.GuiObject.GuiState|GuiState` จะทำงาน
  ตามปกติ.

ใน `Class.GuiObject`:

- เมื่อการตั้งค่า `Class.GuiObject.Interactable|Interactable` ที่อยู่บน
  `Class.GuiButton` ถูกตั้งค่าเป็น `false` สถานะของ
  `Class.GuiObject.GuiState|GuiState` จะถูกตั้งค่าเป็น
  `Enum.GuiState.NonInteractable|NonInteractable` อยู่เสมอ.
- เมื่อการตั้งค่า `Class.GuiObject.Interactable|Interactable` ที่อยู่บน
  `Class.GuiButton` ถูกตั้งค่าเป็น `true` สถานะของ
  `Class.GuiObject.GuiState|GuiState` จะทำงานตามปกติอีกครั้ง.


GuiObject.Interactable

กำหนดว่าคุณสามารถโต้ตอบกับ `Class.GuiButton` ได้หรือไม่ หรือ
สถานะของ `Enum.GuiState|GuiState` ของ `Class.GuiObject` เปลี่ยนแปลงหรือไม่.


คุณสมบัตินี้ควบคุมลำดับการจัดเรียงของ `Class.GuiObject` เมื่อ
ใช้ `Class.UIGridStyleLayout` (เช่น `Class.UIListLayout` หรือ
`Class.UIPageLayout`) โดยตั้งค่า `Class.UIGridStyleLayout.SortOrder|SortOrder`
เป็น `Enum.SortOrder.LayoutOrder`. ไม่มีฟังก์ชันใด ๆ หากวัตถุ
ไม่มีโครงสร้างเลย์เอาต์ของ UI อื่น.

`Class.GuiObject|GuiObjects` จะถูกจัดเรียงตามลำดับที่สูงขึ้นโดยค่า
ที่ต่ำกว่าจะมีลำดับก่อนค่าที่สูงกว่า. วัตถุที่มีค่าเท่ากันจะถูก
จัดเรียงตามลำดับที่ถูกเพิ่มเข้ามา.

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

ดูเพิ่มเติมที่ `Class.GuiObject.ZIndex|ZIndex` ซึ่งกำหนดลำดับการ
**เรนเดอร์** ของวัตถุแทนลำดับการจัดเรียง.


GuiObject.LayoutOrder

ควบคุมลำดับการจัดเรียงของ `Class.GuiObject` เมื่อใช้งานร่วมกับ
`Class.UIGridStyleLayout`.


ตัวอย่างนี้แสดงให้เห็นถึงวิธีการเปิดใช้งานการนำทางด้วย Gamepad ผ่านกริดของ
`GuiObject|GUI` โดยไม่ต้องเชื่อมต่อด้วยตนเอง
`Class.GuiObject.NextSelectionUp`, `Class.GuiObject.NextSelectionDown`, และ
`GuiObject|NextSelectionRight`, และ `Class.GuiObject.NextSelectionLeft`
คุณสมบัติสำหรับทุกองค์ประกอบในกริด

โปรดทราบว่าตัวอย่างโค้ดนี้สมมติว่าคุณ `UIGridLayout` ถูกจัดเรียงตาม
`Class.UIGridLayout.SortOrder|name` ซึ่งองค์ประกอบต่างๆจะถูกตั้งชื่อในลำดับเลขต่อเนื่อง

โค้ดนี้อิงจากสิ่งนี้เพื่อตั้งค่าคุณสมบัติ NextSelection สำหรับทุก
`GuiObjects` ในระดับเดียวกันกับ UIGridLayout ในตัวอย่างของเรา
UIGridLayoutObject และองค์ประกอบ GUI ภายในกริดเป็นลูกทั้งหมดของ
`Frame` ที่ชื่อ _"Container"_ โค้ด
`Class.Instance:GetChildren()|gets the children` ของ _"Container"_ และทำการวนซ้ำ
ผ่านแต่ละลูก ลูกที่ไม่ใช่ GuiObjects จะถูกละเลย สำหรับแต่ละองค์ประกอบ GUI
โค้ดจะพยายามกำหนดคุณสมบัติ NextSelection โดยใช้ตรรกะต่อไปนี้:

1. เริ่มต้นที่ 1 ชื่อขององค์ประกอบ GUI ทั้งหมดจะตรงกับตำแหน่งใน
   กริด
2. ซ้าย: รายการทางซ้ายจะมีหมายเลขน้อยกว่ารายการปัจจุบัน 1
3. ขวา: รายการทางขวาจะมีหมายเลขมากกว่ารายการปัจจุบัน 1
4. ขึ้น: รายการด้านบน (ขึ้น) จะมีจำนวน GUI ในแถวที่น้อยกว่ารายการปัจจุบัน 1
5. ลง: รายการด้านล่าง (ลง) จะมีจำนวน GUI ในแถวที่มากกว่ารายการปัจจุบัน นอกจากนี้ตรรกะนี้ยังอนุญาตให้กับองค์ประกอบ GUI ที่
   เริ่มต้นและสิ้นสุดแถว (ยกเว้นองค์ประกอบแรกและสุดท้าย) สามารถวนไปยังแถวถัดไปและก่อนหน้าได้ หากไม่พบองค์ประกอบที่อยู่ทางซ้าย ขวา ขึ้น หรือ ลง\, NextSelection จะยังคงเป็น nil และการเลื่อนตัวเลือก Gamepad ในทิศทางนั้นจะไม่เปลี่ยน GUI ที่เลือก

ตัวอย่างนี้ยังมีโค้ดเพื่อตรวจสอบกริดโดยใช้ปุ่มลูกศร (ขึ้น,
ลง, ซ้าย, ขวา) บนแป้นพิมพ์ของคุณแทนการใช้เกมพอด ซึ่งเผื่อถ้าคุณไม่มีเกมพอดในการทดสอบ โค้ดส่วนนี้จะเลือกองค์ประกอบที่ชื่อ _"1"_
โดยการกำหนดให้กับคุณสมบัติ `Class.GuiService.SelectedObject`.

คุณสมบัตินี้ตั้งค่าตัวเลือก `Class.GuiObject` ที่จะถูกเลือกเมื่อผู้ใช้
เคลื่อนที่ตัวเลือก [gamepad](/input/gamepad) ลง. หากคุณสมบัตินี้
ว่างเปล่า การเคลื่อนตัว gamepad ลงจะไม่เปลี่ยนแปลง GUI ที่เลือก.

การเคลื่อนที่ตัวเลือก gamepad ลงจะตั้งค่า
`Class.GuiService.SelectedObject` เป็นวัตถุนี้เว้นแต่ GUI จะไม่
`Class.GuiObject.Selectable|Selectable`. หมายเหตุว่าคุณสมบัตินี้สามารถ
ตั้งเป็นองค์ประกอบ GUI ได้แม้ว่าจะไม่
`Class.GuiObject.Selectable|Selectable`, ดังนั้นคุณควรตรวจสอบให้แน่ใจว่า
ค่าเลือกได้ของ GUI ตรงกับพฤติกรรมที่คาดหวัง.

ดูเพิ่มเติมที่ `Class.GuiObject.NextSelectionUp|NextSelectionUp`,
`Class.GuiObject.NextSelectionLeft|NextSelectionLeft`, และ
`Class.GuiObject.NextSelectionRight|NextSelectionRight`.


GuiObject.NextSelectionDown

ตั้งค่าตัวเลือก `Class.GuiObject` ที่จะถูกเลือกเมื่อเคลื่อน
ที่ตัวเลือก gamepad ลง.


คุณสมบัตินี้ตั้งค่าตัวเลือก `Class.GuiObject` ที่จะถูกเลือกเมื่อผู้ใช้
เคลื่อนที่ตัวเลือก [gamepad](/input/gamepad) ไปทางซ้าย. หาก
คุณสมบัตินี้ว่างเปล่า การเคลื่อนตัว gamepad ไปทางซ้ายจะไม่เปลี่ยนแปลง
GUI ที่เลือก.

การเคลื่อนที่ตัวเลือก gamepad ไปทางซ้ายจะตั้งค่า
`Class.GuiService.SelectedObject` เป็นวัตถุนี้เว้นแต่ GUI จะไม่
`Class.GuiObject.Selectable|Selectable`. หมายเหตุว่าคุณสมบัตินี้สามารถ
ตั้งเป็นองค์ประกอบ GUI ได้แม้ว่าจะไม่
`Class.GuiObject.Selectable|Selectable`, ดังนั้นคุณควรตรวจสอบให้แน่ใจว่า
ค่าเลือกได้ของ GUI ตรงกับพฤติกรรมที่คาดหวัง.

ดูเพิ่มเติมที่ `Class.GuiObject.NextSelectionUp|NextSelectionUp`,
`Class.GuiObject.NextSelectionDown|NextSelectionDown`, และ
`Class.GuiObject.NextSelectionRight|NextSelectionRight`.


GuiObject.NextSelectionLeft

ตั้งค่าตัวเลือก `Class.GuiObject` ที่จะถูกเลือกเมื่อเคลื่อน
ที่ตัวเลือก gamepad ไปทางซ้าย.


คุณสมบัตินี้ตั้งค่าตัวเลือก `Class.GuiObject` ที่จะถูกเลือกเมื่อผู้ใช้
เคลื่อนที่ตัวเลือก [gamepad](/input/gamepad) ไปทางขวา. หาก
คุณสมบัตินี้ว่างเปล่า การเคลื่อนตัว gamepad ไปทางขวาจะไม่เปลี่ยนแปลง
GUI ที่เลือก.

การเคลื่อนที่ตัวเลือก gamepad ไปทางขวาจะตั้งค่า
`Class.GuiService.SelectedObject` เป็นวัตถุนี้เว้นแต่ GUI จะไม่
`Class.GuiObject.Selectable|Selectable`. หมายเหตุว่าคุณสมบัตินี้สามารถ
ตั้งเป็นองค์ประกอบ GUI ได้แม้ว่าจะไม่
`Class.GuiObject.Selectable|Selectable`, ดังนั้นคุณควรตรวจสอบให้แน่ใจว่า
ค่าเลือกได้ของ GUI ตรงกับพฤติกรรมที่คาดหวัง.

ดูเพิ่มเติมที่ `Class.GuiObject.NextSelectionUp|NextSelectionUp`,
`Class.GuiObject.NextSelectionDown|NextSelectionDown`, และ
`Class.GuiObject.NextSelectionLeft|NextSelectionLeft`.


GuiObject.NextSelectionRight

ตั้งค่าตัวเลือก `Class.GuiObject` ที่จะถูกเลือกเมื่อเคลื่อน
ที่ตัวเลือก gamepad ไปทางขวา.


คุณสมบัตินี้ตั้งค่าตัวเลือก `Class.GuiObject` ที่จะถูกเลือกเมื่อผู้ใช้
เคลื่อนที่ตัวเลือก [gamepad](/input/gamepad) ขึ้นด้านบน. หาก
คุณสมบัตินี้ว่างเปล่า การเคลื่อนตัว gamepad ขึ้นด้านบนจะไม่เปลี่ยนแปลง
GUI ที่เลือก.

การเคลื่อนที่ตัวเลือก gamepad ขึ้นด้านบนจะตั้งค่า
`Class.GuiService.SelectedObject` เป็นวัตถุนี้เว้นแต่ GUI จะไม่
`Class.GuiObject.Selectable|Selectable`. หมายเหตุว่าคุณสมบัตินี้สามารถ
ตั้งเป็นองค์ประกอบ GUI ได้แม้ว่าจะไม่
`Class.GuiObject.Selectable|Selectable`, ดังนั้นคุณควรตรวจสอบให้แน่ใจว่า
ค่าเลือกได้ของ GUI ตรงกับพฤติกรรมที่คาดหวัง.

ดูเพิ่มเติมที่ `Class.GuiObject.NextSelectionDown|NextSelectionDown`,
`Class.GuiObject.NextSelectionLeft|NextSelectionLeft`,
`Class.GuiObject.NextSelectionRight|NextSelectionRight`.


GuiObject.NextSelectionUp

ตั้งค่าตัวเลือก `Class.GuiObject` ที่จะถูกเลือกเมื่อเคลื่อน
ที่ตัวเลือก gamepad ขึ้นด้านบน.


คุณสมบัตินี้กำหนดตำแหน่งพิกเซลและสเกลของ `Class.GuiObject`
โดยใช้ `Datatype.UDim2`. ตำแหน่งจะอยู่ตรงกลางรอบ
`Class.GuiObject.AnchorPoint` ของวัตถุ.

ตำแหน่งสเกลขึ้นอยู่กับขนาดขององค์ประกอบ GUI แม่ โดยหากมี.

ส่วนที่เป็นพิกเซลของค่า `Datatype.UDim2` จะเหมือนกันไม่ว่า
ขนาดของ GUI แม่จะเป็นเช่นไร ค่าเหล่านี้แทนตำแหน่งของวัตถุ
ในพิกเซล. ขนาดพิกเซลจริงของวัตถุสามารถอ่านได้จาก
คุณสมบัติ `Class.GuiBase2d.AbsolutePosition`.


GuiObject.Position

กำหนดตำแหน่งพิกเซลและสเกลของ `Class.GuiObject`.


คลาสสรุปสำหรับออบเจ็กต์ส่วนต่อประสานผู้ใช้แบบ 2D.

/reference/engine/classes/CanvasGroup.yaml