`Class.TextChannelWindow` เป็น `Class.GuiObject` ที่แสดงข้อความแชทข้อความในประสบการณ์จาก `Class.TextChannel` ที่เชื่อมโยง วางไว้ใต้ `Class.ScreenGui` หรือ `Class.LayerCollector` ที่สืบทอดอื่นเพื่อแสดงแชทในตำแหน่งและรูปแบบที่กำหนดเอง

ตั้งค่า `Class.TextChannelWindow.Target|Target` เป็น `Class.TextChannel` เพื่อเลือกว่าข้อความจากช่องไหนที่หน้าต่างจะแสดง หน้าต่างจะลงทะเบียนตัวเองกับ `Class.TextChatService` เมื่อถูกเพิ่มเข้าไปในโมเดลข้อมูล

เด็กที่ยอมรับ: `Class.UICorner`, `Class.UIAspectRatioConstraint`, `Class.UISizeConstraint`, และสคริปต์ (`Class.LocalScript`, `Class.Script`, `Class.ModuleScript`); ประเภทเด็กอื่น ๆ จะถูกปฏิเสธ


TextChannelWindow

การอ้างอิงถึง `Class.TextChannel` ที่ข้อความของมันถูกแสดงในหน้าต่างนี้ เมื่อถูกตั้งค่า หน้าต่างจะแสดงข้อความจากช่องที่ระบุ การตั้งค่านี้เป็น `nil` จะตัดการเชื่อมต่อหน้าต่างจากช่องใด ๆ ดังนั้นจึงไม่แสดงข้อความใด ๆ

ค่าปริยายคือ `nil` (ไม่มีช่องที่เชื่อมโยง)


TextChannelWindow.Target

`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 มันจะพิมพ์
X และ Y ของตำแหน่งที่ผู้เล่นหยุดลาก GUI หากผู้เล่นหยุดลากวัตถุที่ 189, 180 ข้อความด้านล่างจะพิมพ์ว่า ผู้เล่นหยุดลาก GuiObject ที่ (189, 180)


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

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

GuiObject.DragStopped

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

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

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

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

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


เหตุการณ์นี้เกิดขึ้นเมื่อผู้ใช้เริ่มโต้ตอบกับ `Class.GuiObject`
ผ่านอุปกรณ์อินเตอร์เฟซมนุษย์-คอมพิวเตอร์ (ปุ่มเมาส์กด, เริ่มสัมผัส,
ปุ่มคีย์บอร์ดกด, ฯลฯ).

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

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

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

GuiObject.InputBegan

input

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

เกิดขึ้นเมื่อผู้ใช้เริ่มโต้ตอบผ่านอุปกรณ์อินเตอร์เฟซมนุษย์-คอมพิวเตอร์
(ปุ่มเมาส์กด, เริ่มสัมผัส, ปุ่มคีย์บอร์ดกด, ฯลฯ).

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

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


เหตุการณ์นี้เกิดขึ้นเมื่อผู้ใช้เปลี่ยนวิธีการที่พวกเขากำลังโต้ตอบผ่านอุปกรณ์
อินเตอร์เฟซมนุษย์-คอมพิวเตอร์ (ปุ่มเมาส์กด, เริ่มสัมผัส, ปุ่มคีย์บอร์ดกด,
ฯลฯ).

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

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

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

GuiObject.InputChanged

เกิดขึ้นเมื่อผู้ใช้เปลี่ยนวิธีการที่พวกเขากำลังโต้ตอบผ่านอุปกรณ์อินเตอร์เฟซ
มนุษย์-คอมพิวเตอร์ (ปุ่มเมาส์กด, เริ่มสัมผัส, ปุ่มคีย์บอร์ดกด,
etc).

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

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


เหตุการณ์ InputEnded จะเกิดขึ้นเมื่อผู้ใช้หยุดโต้ตอบผ่านอุปกรณ์
อินเตอร์เฟซมนุษย์-คอมพิวเตอร์ (ปุ่มเมาส์กด, เริ่มสัมผัส, ปุ่มคีย์บอร์ดกด,
ฯลฯ).

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

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

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

GuiObject.InputEnded

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

เกิดขึ้นเมื่อผู้ใช้หยุดโต้ตอบผ่านอุปกรณ์อินเตอร์เฟซมนุษย์-คอมพิวเตอร์
(ปุ่มเมาส์กด, เริ่มสัมผัส, ปุ่มคีย์บอร์ดกด, ฯลฯ).

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


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

โปรดอย่าเชื่อถือในอาร์กิวเมนต์ `x` และ `y` ที่ส่งผ่านโดยเหตุการณ์นี้ว่าเป็น
วิธีที่เชื่อถือได้ในการกำหนดตำแหน่งของเมาส์ของผู้ใช้เมื่อมันเข้าไปใน
GUI. พิกัดเหล่านี้อาจแตกต่างกันแม้ว่าเมาส์จะเข้าไปใน GUI ผ่าน
ขอบเดียวกัน - โดยเฉพาะเมื่อเมาส์เข้าไปในองค์ประกอบอย่างรวดเร็ว. สิ่งนี้
เกิดจากความจริงที่ว่าพิกัดแสดงถึงตำแหน่งของเมาส์เมื่อ
เหตุการณ์เกิดขึ้นแทนที่จะเป็นช่วงเวลาที่แน่นอนที่เมาส์เข้าไปใน 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 ผ่าน
ขอบเดียวกัน - โดยเฉพาะเมื่อเมาส์ออกจากองค์ประกอบอย่างรวดเร็ว. สิ่งนี้
เกิดจากความจริงที่ว่าพิกัดแสดงถึงตำแหน่งของเมาส์เมื่อ
เหตุการณ์เกิดขึ้นแทนที่จะเป็นช่วงเวลาที่แน่นอนที่เมาส์ออกจาก 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

พิกัด **Y** ของเมาส์ของผู้ใช้。

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

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

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


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

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

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

GuiObject.SelectionGained

เกิดขึ้นเมื่อ GuiObject ถูกเน้นด้วยตัวเลือก Gamepad。

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

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


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

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

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

GuiObject.SelectionLost

เกิดขึ้นเมื่อผู้เลือก Gamepad หยุดเน้นที่ GuiObject。

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

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

GuiObject.TouchLongPress

touchPositions

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

state

ค่า `Enum.UserInputState` ที่อธิบายสถานะของท่าทาง:

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

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

ตัวอย่างโค้ดนี้มีไว้เพื่อวางใน `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

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

totalTranslation

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

velocity

ระบุว่าท่าทางกำลังดำเนินการอย่างรวดเร็วในแต่ละ
มิติเท่าใด。

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

เกิดขึ้นเมื่อผู้เล่นขยับนิ้วบน UI องค์ประกอบ。

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


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

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

GuiObject.TouchPinch

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

scale

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

ค่าลอยที่ระบุว่าท่าทางการบีบกำลังเกิดขึ้นอย่างรวดเร็วเพียงใด。

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

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


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

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

GuiObject.TouchRotate

rotation

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

ค่าลอยที่ระบุว่าท่าทางกำลังดำเนินการอย่างรวดเร็วเพียงใด。

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

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


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

GuiObject.TouchSwipe

swipeDirection

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

numberOfTouches

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

เกิดขึ้นเมื่อผู้เล่นทำท่าทางการปัดบน UI องค์ประกอบ。

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

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

GuiObject.TouchTap

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

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


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

ฟังก์ชันนี้จะส่งคืนว่าทวีตจะเล่นหรือไม่ มันจะไม่เล่นหาก
ทวีตอื่นกำลังทำงานอยู่บน `Class.GuiObject` และพารามิเตอร์การเขียนทับ
เป็น `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` หากทวีตอื่นกำลังทำงานอยู่และการเขียนทับถูกตั้งค่าเป็น `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` หากทวีตอื่นกำลังทำงานอยู่และการเขียนทับถูกตั้งค่าเป็น `false`.

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

GuiObject:TweenSizeAndPosition

ทิศทางที่ควรทำให้ GUI สู่ _endSize_ และ
_endPosition_.

สไตล์ที่ควรทำให้ GUI สู่ _endSize_ และ _endPosition_.

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

GuiObject

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

คุณสมบัตินี้กำหนดว่าวัตถุ `Class.GuiObject` จะรับข้อมูลไปยัง
พื้นที่ 3D หรือไม่ เช่น โมเดลที่อยู่เบื้องหลังที่มีคลาส `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 นี้จะรับข้อมูลหรือไม่.

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


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

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

GuiObject.AnchorPoint

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

สคริปต์ต่อไปนี้สร้างเฟรมพาเรนต์ที่มีขนาดอัตโนมัติพร้อมกับ
`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`.

คุณสมบัตินี้กำหนดความโปร่งใสของพื้นหลังและขอบของ `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` โดยสัมพันธ์กับมิติของมันโดยใช้ enum ที่มีชื่อเดียวกัน,
`Enum.BorderMode`.

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

GuiObject.BorderMode

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

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

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

GuiObject.BorderSizePixel

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

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

#### พฤติกรรมการหมุน

เมื่อ `Class.StarterGui.ClipsDescendantsSupportsRotation` ถูกเปิดใช้งาน,
การตัดจะทำงานอย่างถูกต้องสำหรับรูปร่างที่หมุน อย่างไรก็ตาม การตัด **โดย**
รูปร่างที่หมุน (เมื่อพ่อแม่ที่ตัดเองถูกหมุน) หรือโดยมุมโค้ง (`Class.UICorner`) ไม่ได้รับการสนับสนุน.

เมื่อ `Class.StarterGui.ClipsDescendantsSupportsRotation` **ไม่ได้**
เปิดใช้งานและ `Class.GuiObject` นี้หรือ `Class.GuiObject` บรรพบุรุษใด ๆ มี
`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` หรือไม่.

ควบคุมว่าและในระดับใดที่ `Class.GuiObject` จะรับข้อมูล
ที่เกิดขึ้นเหนือมัน โดยใช้ `Enum.InputSink` การรับข้อมูลจะป้องกันไม่ให้ข้อมูล
ผ่านไปยังวัตถุที่อยู่ด้านหลังองค์ประกอบ รวมถึงวัตถุ 3D
ในโลก เช่น วัตถุที่มี `Class.ClickDetector` หรือ
`Class.DragDetector` โดยค่าเริ่มต้นจะเป็น `Enum.InputSink.None` ยกเว้นใน
วัตถุ `Class.GuiButton` (`Class.ImageButton` และ `Class.TextButton`)
ซึ่งจะมีค่าเริ่มต้นเป็น `Enum.InputSink.Activate`。

- `Enum.InputSink.None` — วัตถุจะไม่รับข้อมูลด้วยตนเอง。
- `Enum.InputSink.Activate` — วัตถุจะรับข้อมูลการกดปุ่มเมาส์และการสัมผัส
  ที่ใช้ในการเปิดใช้งาน แต่จะปล่อยให้ข้อมูลอื่น (เช่น
  การเคลื่อนไหวของเมาส์) ผ่านไป。
- `Enum.InputSink.All` — วัตถุจะรับข้อมูลทั้งหมดที่เกิดขึ้นเหนือมัน。

คุณสมบัตินี้เป็นผู้สืบทอดที่มีความละเอียดมากขึ้นจากคุณสมบัติ
boolean `Class.GuiObject.Active|Active` ซึ่งสามารถรับข้อมูลทั้งหมดหรือ
ไม่มีเลย เหตุการณ์ `Class.GuiObject.InputBegan|InputBegan`,
`Class.GuiObject.InputChanged|InputChanged` และ
`Class.GuiObject.InputEnded|InputEnded` จะเกิดขึ้นไม่ว่าค่าของคุณสมบัตินี้จะเป็นอย่างไร。

GuiObject.InputSink

ควบคุมว่าและอย่างไรที่ `Class.GuiObject` จะรับข้อมูลที่เกิดขึ้น
เหนือมัน。

กำหนดว่าวัตถุ `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 ที่เลือก

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

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

การเลื่อนตัวเลือกเกมแพดลงจะตั้งค่า
`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` ที่จะถูกเลือกเมื่อผู้ใช้เลื่อน
ตัวเลือกเกมแพดลง.

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

การเลื่อนตัวเลือกเกมแพดไปทางซ้ายจะตั้งค่า
`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` ที่จะถูกเลือกเมื่อผู้ใช้เลื่อน
ตัวเลือกเกมแพดไปทางซ้าย.

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

การเลื่อนตัวเลือกเกมแพดไปทางขวาจะตั้งค่า
`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` ที่จะถูกเลือกเมื่อผู้ใช้เลื่อน
ตัวเลือกเกมแพดไปทางขวา.

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

การเลื่อนตัวเลือกเกมแพดขึ้นจะตั้งค่า
`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` ที่จะถูกเลือกเมื่อผู้ใช้เลื่อน
ตัวเลือกเกมแพดขึ้น.

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

ตำแหน่งสเกลสัมพันธ์กับขนาดของวัตถุ GUI แม่ หากมี.

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

GuiObject.Position

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

คลาสนามที่เป็นนามธรรมสำหรับวัตถุอินเตอร์เฟซผู้ใช้ 2D.

/reference/engine/classes/TextChannelWindow.yaml