`Class.TextChannelWindow` là một `Class.GuiObject` hiển thị các tin nhắn trò chuyện văn bản trong trải nghiệm từ một `Class.TextChannel` liên kết. Đặt nó dưới một `Class.ScreenGui` hoặc một hậu duệ `Class.LayerCollector` khác để hiển thị trò chuyện ở một vị trí và bố cục tùy chỉnh.

Đặt `Class.TextChannelWindow.Target|Target` thành một `Class.TextChannel` để chọn kênh nào mà cửa sổ hiển thị tin nhắn. Cửa sổ tự đăng ký với `Class.TextChatService` khi được thêm vào mô hình dữ liệu.

Các thuộc tính được thiết lập trên `Class.ChatWindowConfiguration` không áp dụng cho cửa sổ này.

Các đối tượng con được chấp nhận: `Class.UICorner`, `Class.UIAspectRatioConstraint`, `Class.UISizeConstraint`, và các script (`Class.LocalScript`, `Class.Script`, `Class.ModuleScript`); các loại đối tượng con khác sẽ bị từ chối.

TextChannelWindow

Một tham chiếu đến `Class.TextChannel` mà tin nhắn của nó được cửa sổ này hiển thị.
Khi được thiết lập, cửa sổ hiển thị tin nhắn từ kênh đã chỉ định. Đặt thuộc tính này thành `nil` sẽ ngắt kết nối cửa sổ khỏi bất kỳ kênh nào để nó không hiển thị tin nhắn.

Giá trị mặc định là `nil` (không có kênh nào được liên kết).

TextChannelWindow.Target

TextChannel mà các tin nhắn của nó được hiển thị trong cửa sổ này.


Hiển thị kênh RBXGeneral trong một cửa sổ tùy chỉnh với phông chữ không mặc định. Dán
vào một LocalScript.


Phông chữ được sử dụng để hiển thị tin nhắn của cửa sổ này và thanh nhập của nó. Chỉ được áp dụng khi `Class.TextChannelWindow.UseDefaultFont` là `false`.

TextChannelWindow.FontFace

Phông chữ được sử dụng để hiển thị văn bản trong cửa sổ này.

Khi `true` (mặc định), cửa sổ sử dụng phông chữ mặc định của nền tảng trực tiếp.
Khi `false`, cửa sổ sử dụng `Class.TextChannelWindow.FontFace|FontFace`.

TextChannelWindow.UseDefaultFont

Liệu cửa sổ này có sử dụng phông chữ mặc định của nền tảng trực tiếp hay không.

Một GuiObject hiển thị các tin nhắn trò chuyện từ một TextChannel liên kết.


`Class.GuiObject` là một lớp trừu tượng (giống như `Class.BasePart`) cho một đối tượng giao diện người dùng 2D. Nó định nghĩa tất cả các thuộc tính liên quan đến việc hiển thị một đối tượng giao diện người dùng đồ họa (GUI) như `Class.GuiObject.Size|Size` và `Class.GuiObject.Position|Position`. Nó cũng có một số thuộc tính chỉ đọc hữu ích như `Class.GuiObject.AbsolutePosition|AbsolutePosition`, `Class.GuiObject.AbsoluteSize|AbsoluteSize`, và `Class.GuiObject.AbsoluteRotation|AbsoluteRotation`.

Để thao tác bố cục của các đối tượng GUI theo những cách đặc biệt, bạn có thể sử dụng một cấu trúc bố cục như [list/flex](/ui/list-flex-layouts) hoặc [grid](/ui/grid-table-layouts), và bạn có thể tạo kiểu cho chúng ngoài các thuộc tính cốt lõi của chúng thông qua [appearance modifiers](/ui/appearance-modifiers).

Mặc dù có thể phát hiện các sự kiện nút chuột trên bất kỳ đối tượng GUI nào bằng cách sử dụng `Class.GuiObject.InputBegan|InputBegan` và `Class.GuiObject.InputEnded|InputEnded`, chỉ có `Class.ImageButton` và `Class.TextButton` có các sự kiện chuyên dụng thuận tiện như `Class.TextButton.Activated|Activated` để phát hiện nhấp/nhấn.

Ví dụ dưới đây giả định rằng nó nằm trong một GuiObject như `TextButton`, và
rằng thuộc tính `Class.GuiObject.Draggable` được đặt thành true. Nó sẽ in ra
UDim2 của vị trí mà người chơi bắt đầu kéo đối tượng.

Sự kiện này được kích hoạt khi một người chơi bắt đầu kéo đối tượng.

Xem thêm `Class.GuiObject.DragStopped`.

GuiObject.DragBegin

initialPosition

Một giá trị `Datatype.UDim2` của vị trí của `Class.GuiObject` trước khi bất kỳ thao tác kéo nào bắt đầu.

Được kích hoạt khi một người chơi bắt đầu kéo đối tượng.

Ví dụ dưới đây giả định rằng nó nằm trong một GuiObject như `TextButton`, và
rằng thuộc tính `Class.GuiObject.Draggable` được đặt thành true. Nó sẽ in ra
tọa độ X và Y của nơi người chơi dừng kéo GUI. Ví dụ, nếu người chơi dừng kéo
đối tượng tại 189, 180 thì dưới đây sẽ in ra Người chơi đã dừng kéo GuiObject tại (189, 180)


Sự kiện này được kích hoạt khi một người chơi dừng kéo đối tượng.

Xem thêm `Class.GuiObject.DragBegin`.

GuiObject.DragStopped

Vị trí màn hình **X** của chuột tính bằng pixel, tương đối với góc trên bên trái của màn hình.

Vị trí màn hình **Y** của chuột tính bằng pixel, tương đối với góc trên bên trái của màn hình.

Được kích hoạt khi một người chơi dừng kéo đối tượng.

Ví dụ sau đây minh họa một trong nhiều ví dụ sử dụng để xử lý đầu vào của người dùng
 từ InputBegan tùy thuộc vào loại của nó.

Để điều này hoạt động như mong đợi, nó phải được đặt trong một `LocalScript`
 và là một con của _gui_.


Sự kiện này được kích hoạt khi một người dùng bắt đầu tương tác với `Class.GuiObject` qua thiết bị Giao diện Người-Máy (Nút chuột xuống, bắt đầu chạm, nút bàn phím xuống, v.v.).

`Class.UserInputService` có một sự kiện có tên tương tự không bị giới hạn cho một phần tử UI cụ thể: `Class.UserInputService.InputBegan`.

Sự kiện này sẽ luôn được kích hoạt bất kể trạng thái trò chơi.

Xem thêm `Class.GuiObject.InputEnded` và `Class.GuiObject.InputChanged`.

GuiObject.InputBegan

input

Một `Class.InputObject`, chứa dữ liệu hữu ích để truy vấn đầu vào của người dùng như `Enum.UserInputType|loại đầu vào`, `Enum.UserInputState|trạng thái đầu vào`, và `Class.InputObject.Position|tọa độ màn hình của đầu vào`.

Được kích hoạt khi một người dùng bắt đầu tương tác qua thiết bị Giao diện Người-Máy (Nút chuột xuống, bắt đầu chạm, nút bàn phím xuống, v.v.).

Ví dụ sau đây minh họa một trong nhiều ví dụ sử dụng để xử lý đầu vào của người dùng từ InputChanged tùy thuộc vào loại của nó.

Để điều này hoạt động như mong đợi, nó phải được đặt trong một `LocalScript` và là một con của _gui_.


Sự kiện này được kích hoạt khi một người dùng thay đổi cách họ tương tác qua thiết bị Giao diện Người-Máy (Nút chuột xuống, bắt đầu chạm, nút bàn phím xuống, v.v.).

`Class.UserInputService` có một sự kiện có tên tương tự không bị giới hạn cho một phần tử UI cụ thể: `Class.UserInputService.InputChanged`.

Sự kiện này sẽ luôn được kích hoạt bất kể trạng thái trò chơi.

Xem thêm `Class.GuiObject.InputBegan` và `Class.GuiObject.InputEnded`.

GuiObject.InputChanged

Được kích hoạt khi một người dùng thay đổi cách họ tương tác qua thiết bị Giao diện Người-Máy (Nút chuột xuống, bắt đầu chạm, nút bàn phím xuống, v.v.).

Ví dụ sau đây minh họa một trong nhiều ví dụ sử dụng để xử lý đầu vào của người dùng từ InputEnded tùy thuộc vào loại của nó.

Để điều này hoạt động như mong đợi, nó phải được đặt trong một `LocalScript` và là một con của _gui_.


Sự kiện InputEnded được kích hoạt khi một người dùng dừng tương tác qua thiết bị Giao diện Người-Máy (Nút chuột xuống, bắt đầu chạm, nút bàn phím xuống, v.v.).

`Class.UserInputService` có một sự kiện có tên tương tự không bị giới hạn cho một phần tử UI cụ thể: `Class.UserInputService.InputEnded`.

Sự kiện này sẽ luôn được kích hoạt bất kể trạng thái trò chơi.

Xem thêm `Class.GuiObject.InputBegan` và `Class.GuiObject.InputChanged`.

GuiObject.InputEnded

Một `Class.InputObject`, chứa dữ liệu hữu ích để truy vấn đầu vào của người dùng như `Enum.UserInputType`, `Enum.UserInputState`, và `Class.InputObject.Position`.

Được kích hoạt khi một người dùng dừng tương tác qua thiết bị Giao diện Người-Máy (Nút chuột xuống, bắt đầu chạm, nút bàn phím xuống, v.v.).

Ví dụ sau đây in ra vị trí của chuột, tính bằng pixel, khi nó vào phần tử GUI.


Sự kiện MouseEnter được kích hoạt khi một người dùng di chuyển chuột vào một phần tử `Class.GuiObject`.

Xin đừng dựa vào các tham số `x` và `y` được truyền bởi sự kiện này như một cách chắc chắn để xác định vị trí của chuột người dùng khi nó vào một GUI. Các tọa độ này có thể thay đổi ngay cả khi chuột vào GUI qua cùng một cạnh - đặc biệt khi chuột vào phần tử một cách nhanh chóng. Điều này là do các tọa độ chỉ ra vị trí của chuột khi sự kiện được kích hoạt chứ không phải vào thời điểm chính xác chuột vào GUI.

Sự kiện này được kích hoạt ngay cả khi phần tử GUI được hiển thị bên dưới một phần tử khác.

Nếu bạn muốn theo dõi khi chuột của người dùng rời khỏi một phần tử GUI, bạn có thể sử dụng sự kiện `Class.GuiObject.MouseLeave`.

##### Xem thêm

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

GuiObject.MouseEnter

Tọa độ màn hình **X** của chuột tính bằng pixel, tương đối với góc trên bên trái của màn hình.

Tọa độ màn hình **Y** của chuột tính bằng pixel, tương đối với góc trên bên trái của màn hình.

Kích hoạt khi một người dùng di chuyển chuột vào một phần tử GUI.

Sự kiện MouseLeave được kích hoạt khi một người dùng di chuyển chuột ra khỏi một phần tử `Class.GuiObject`.

Xin đừng dựa vào các tham số `x` và `y` được truyền bởi sự kiện này như một cách chắc chắn để xác định vị trí của chuột người dùng khi nó rời khỏi một GUI. Các tọa độ này có thể thay đổi ngay cả khi chuột rời khỏi GUI qua cùng một cạnh - đặc biệt khi chuột rời khỏi phần tử một cách nhanh chóng. Điều này là do các tọa độ chỉ ra vị trí của chuột khi sự kiện được kích hoạt chứ không phải vào thời điểm chính xác chuột rời khỏi GUI.

Sự kiện này được kích hoạt ngay cả khi phần tử GUI được hiển thị bên dưới một phần tử khác.

##### Xem thêm

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

GuiObject.MouseLeave

Kích hoạt khi một người dùng di chuyển chuột ra khỏi một phần tử GUI.

Sự kiện này được kích hoạt mỗi khi người dùng di chuyển chuột của họ trong khi nó nằm bên trong một
`Class.GuiObject` element. Nó tương tự như `Class.Mouse.Move`, sự kiện này
được kích hoạt bất kể chuột của người dùng có nằm trên một phần tử GUI hay không.

Lưu ý, sự kiện này được kích hoạt khi vị trí của chuột được cập nhật, do đó nó
sẽ được kích hoạt liên tục trong khi đang di chuyển.

Các tham số `x` và `y` chỉ ra tọa độ màn hình đã được cập nhật của chuột người dùng
tính bằng pixel. Những thông tin này có thể hữu ích để xác định vị trí của chuột
trên GUI, màn hình, và delta kể từ vị trí trước đó của chuột nếu nó đang được theo dõi trong một biến toàn cục.

Mã dưới đây minh họa cách xác định độ lệch `Datatype.Vector2` của chuột người dùng
so với một phần tử GUI.
`Class.GuiObject.AbsolutePosition|AbsolutePosition` được đo bên trong
khoảng cách GUI của màn hình, trong khi các tham số `x` và `y` của sự kiện này là
các tọa độ màn hình bao gồm nó, vì vậy mẫu gọi
`Class.GuiService:GetGuiInset()|GetGuiInset()` để điều chỉnh hai không gian
thay vì giả định một kích thước khoảng cách cố định.

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

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

local mouse = Players.LocalPlayer:GetMouse()

local function getPosition(X, Y)
	local topLeftInset = GuiService:GetGuiInset()

	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 - topLeftInset.Y))
	print(pos)
end

CustomScrollingFrame.MouseMoved:Connect(getPosition)
```
Lưu ý rằng sự kiện này có thể không được kích hoạt chính xác khi chuột của người dùng vào hoặc
ra khỏi một phần tử GUI. Do đó, các tham số `x` và `y` có thể không khớp hoàn hảo
với các tọa độ của các cạnh của GUI.

##### Xem Thêm

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

GuiObject.MouseMoved

Kích hoạt bất cứ khi nào một người dùng di chuyển chuột trong khi nó đang ở trong một phần tử GUI.

Sự kiện WheelBackward được kích hoạt khi một người dùng cuộn bánh xe chuột của họ trở lại khi chuột đang ở trên một phần tử `Class.GuiObject`. Nó tương tự như `Class.Mouse.WheelBackward`, kích hoạt bất kể chuột của người dùng có ở trên một phần tử GUI hay không.

Sự kiện này được kích hoạt chỉ như một chỉ báo về chuyển động ngược của bánh xe. Điều này có nghĩa là các tham số tọa độ chuột **X** và **Y** không thay đổi do sự kiện này. Các tọa độ này chỉ thay đổi khi chuột di chuyển, điều này có thể được theo dõi bởi sự kiện `Class.GuiObject.MouseMoved`.

##### Xem thêm

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

GuiObject.MouseWheelBackward

Kích hoạt khi một người dùng cuộn bánh xe chuột của họ trở lại khi chuột đang ở trên một phần tử GUI.

Sự kiện WheelForward được kích hoạt khi một người dùng cuộn bánh xe chuột của họ về phía trước khi chuột đang ở trên một phần tử `Class.GuiObject`. Nó tương tự như `Class.Mouse.WheelForward`, kích hoạt bất kể chuột của người dùng có ở trên một phần tử GUI hay không.

Sự kiện này được kích hoạt chỉ như một chỉ báo về chuyển động tiến của bánh xe. Điều này có nghĩa là các tham số tọa độ chuột **X** và **Y** không thay đổi do sự kiện này. Các tọa độ này chỉ thay đổi khi chuột di chuyển, điều này có thể được theo dõi bởi sự kiện `Class.GuiObject.MouseMoved`.

##### Xem thêm

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

GuiObject.MouseWheelForward

Tọa độ **Y** của chuột người dùng.

Kích hoạt khi một người dùng cuộn bánh xe chuột của họ về phía trước khi chuột đang ở trên một phần tử GUI.

Ví dụ sau đây in một thông điệp khi người dùng chọn đối tượng bằng một
gamepad.

Để điều này hoạt động như mong đợi, nó phải được đặt trong một `LocalScript`
và là một con của _gui_.


Sự kiện này được kích hoạt khi bộ chọn Gamepad bắt đầu tập trung vào `Class.GuiObject`.

Nếu bạn muốn kiểm tra khi bộ chọn Gamepad dừng tập trung vào phần tử GUI, bạn có thể sử dụng sự kiện `Class.GuiObject.SelectionLost`.

Khi một GUI nhận được sự tập trung lựa chọn, giá trị của thuộc tính `Class.GuiService.SelectedObject|SelectedObject` cũng thay đổi thành đối tượng nhận được sự tập trung. Để xác định GUI nào đã nhận được sự tập trung, hãy kiểm tra giá trị của thuộc tính này.

GuiObject.SelectionGained

inputDirection

Hướng điều hướng đã di chuyển lựa chọn đến đối tượng này, hoặc
`Enum.GuiNavigationDirection.None` nếu lựa chọn không thay đổi thông qua
đầu vào điều hướng.


Kích hoạt khi GuiObject đang được tập trung vào với bộ chọn Gamepad.

Ví dụ sau đây in một thông điệp khi phần tử mất tiêu điểm trên
một tay cầm chơi game.

Để điều này hoạt động như mong đợi, nó phải được đặt trong một `LocalScript`
và là một con của _gui_.


Sự kiện này được kích hoạt khi bộ chọn Gamepad dừng tập trung vào `Class.GuiObject`.

Nếu bạn muốn kiểm tra khi bộ chọn Gamepad bắt đầu tập trung vào phần tử GUI, bạn có thể sử dụng sự kiện `Class.GuiObject.SelectionGained`.

Khi một GUI mất sự tập trung lựa chọn, giá trị của thuộc tính `Class.GuiService.SelectionObject|SelectionObject` thay đổi thành `nil` hoặc thành phần GUI nhận được sự tập trung. Để xác định GUI nào đã nhận được sự tập trung, hoặc nếu không có GUI nào được chọn, hãy kiểm tra giá trị của thuộc tính này.

GuiObject.SelectionLost

Hướng điều hướng đã di chuyển lựa chọn ra khỏi đối tượng này,
hoặc `Enum.GuiNavigationDirection.None` nếu lựa chọn không thay đổi
thông qua đầu vào điều hướng.


Kích hoạt khi bộ chọn Gamepad dừng tập trung vào GuiObject.

Mẫu mã này cho phép người chơi điều chỉnh vị trí trên màn hình của một số
phần tử UI, như một `Frame`, bằng cách giữ ngón tay trên phần tử UI trong một khoảng
thời gian ngắn. Sau đó, người chơi di chuyển ngón tay và thả ra. Trong suốt cử chỉ
phần Frame sẽ có màu xanh với viền trắng.


Sự kiện này được kích hoạt sau một khoảng thời gian ngắn khi người chơi giữ ngón tay của họ trên phần tử UI bằng thiết bị hỗ trợ chạm. Nó được kích hoạt với một bảng `Datatype.Vector2` mô tả các vị trí màn hình tương đối của các ngón tay tham gia vào cử chỉ. Ngoài ra, nó được kích hoạt nhiều lần: `Enum.UserInputState.Begin` sau một khoảng thời gian ngắn, `Enum.UserInputState.Change` nếu người chơi di chuyển ngón tay của họ trong suốt cử chỉ, và cuối cùng là `Enum.UserInputState.End`. Thời gian trễ phụ thuộc vào nền tảng; trong Studio, nó dài hơn một chút so với một giây.

GuiObject.TouchLongPress

touchPositions

Một mảng `Datatype.Vector2` mô tả các vị trí **tương đối** của các ngón tay tham gia vào cử chỉ.

state

Một `Enum.UserInputState` mô tả trạng thái của cử chỉ:

- Begin được kích hoạt một lần tại thời điểm bắt đầu của cử chỉ (sau một khoảng
  thời gian ngắn)
- Change được kích hoạt nếu người chơi di chuyển ngón tay trong khi nhấn xuống
- End được kích hoạt một lần tại thời điểm kết thúc của cử chỉ khi họ thả ngón tay.

Kích hoạt khi người chơi bắt đầu, tiếp tục và dừng nhấn lâu phần tử UI.

Mẫu mã này được đặt trong một `LocalScript` bên trong một
`Frame` nằm trong một `Frame` bên ngoài, hoặc một `GuiObject` khác. Nó cho phép người chơi
thao tác vị trí của khung bên trong bằng cách di chuyển ngón tay của họ trên
khung bên ngoài.


Sự kiện này được kích hoạt khi người chơi di chuyển ngón tay trên phần tử UI
sử dụng thiết bị hỗ trợ cảm ứng. Nó được kích hoạt ngay trước khi
`Class.GuiObject.TouchSwipe` xảy ra, và không được kích hoạt với
`Class.GuiObject.TouchTap`. Sự kiện này hữu ích cho phép người chơi
manipulate vị trí của các phần tử UI trên màn hình.

Sự kiện này được kích hoạt với một bảng `Datatype.Vector2` mô tả các
vị trí tương đối trên màn hình của các ngón tay tham gia vào cử chỉ. Ngoài ra,
nó được kích hoạt nhiều lần: `Enum.UserInputState.Begin` sau một
khoảng thời gian ngắn, `Enum.UserInputState.Change` khi người chơi di chuyển ngón tay của họ
trong cử chỉ, và cuối cùng với `Enum.UserInputState.End`.

GuiObject.TouchPan

Một mảng Luau của các đối tượng `Datatype.Vector2`, mỗi đối tượng chỉ ra
vị trí của tất cả các ngón tay tham gia vào cử chỉ.

totalTranslation

Chỉ ra khoảng cách mà cử chỉ pan đã đi từ điểm bắt đầu của nó.

velocity

Chỉ ra tốc độ mà cử chỉ đang được thực hiện trong mỗi
chiều.

Chỉ ra `Enum.UserInputState` của cử chỉ.

Kích hoạt khi người chơi di chuyển ngón tay trên phần tử UI.

Mẫu mã này dành cho một `LocalScript` bên trong một `Frame` nội bộ nằm
trong một `Frame` bên ngoài, hoặc một `GuiObject` khác. Nó cho phép người chơi thay đổi kích thước
của frame nội bộ bằng cách thực hiện cử chỉ `Class.GuiObject.TouchPinch` trên
frame bên ngoài.


Sự kiện này được kích hoạt khi người chơi sử dụng hai ngón tay để thực hiện cử chỉ pinch hoặc pull
trên phần tử UI sử dụng thiết bị hỗ trợ cảm ứng. Một **pinch**
được thực hiện khi hai hoặc nhiều ngón tay di chuyển lại gần nhau, và một **pull**
được thực hiện khi chúng di chuyển ra xa. Sự kiện này được kích hoạt cùng với
`Class.GuiObject.TouchPan`. Sự kiện này hữu ích cho phép người chơi
manipulate tỷ lệ (kích thước) của các phần tử UI trên màn hình, và thường
được sử dụng cho các tính năng phóng to.

Sự kiện này được kích hoạt với một bảng `Datatype.Vector2` mô tả các
vị trí tương đối trên màn hình của các ngón tay tham gia vào cử chỉ. Ngoài ra,
nó được kích hoạt nhiều lần: `Enum.UserInputState.Begin` sau một
khoảng thời gian ngắn, `Enum.UserInputState.Change` khi người chơi di chuyển một ngón tay
trong cử chỉ, và cuối cùng với `Enum.UserInputState.End`. Cần
lưu ý rằng tỷ lệ nên được sử dụng **theo cách nhân**.

GuiObject.TouchPinch

Một mảng Luau của các đối tượng `Datatype.Vector2`, mỗi đối tượng chỉ ra
vị trí của tất cả các ngón tay tham gia vào cử chỉ pinch.

scale

Một số thực chỉ ra sự khác biệt từ điểm bắt đầu của cử chỉ pinch.

Một số thực chỉ ra tốc độ mà cử chỉ pinch đang diễn ra.

Kích hoạt khi người chơi thực hiện cử chỉ pinch hoặc pull bằng hai ngón tay
trên phần tử UI.

Mẫu mã này dành cho một `LocalScript` bên trong một `Frame` nội bộ nằm
trong một `Frame` bên ngoài, hoặc một `GuiObject` khác. Nó cho phép người chơi xoay
frame nội bộ bằng cách thực hiện một cử chỉ `Class.GuiObject.TouchRotate` trên
frame bên ngoài.


Sự kiện này được kích hoạt khi người chơi sử dụng hai ngón tay để thực hiện cử chỉ pinch hoặc pull
trên phần tử UI sử dụng thiết bị hỗ trợ cảm ứng. Xoay xảy ra
khi góc của đường thẳng giữa hai ngón tay thay đổi. Sự kiện này được kích hoạt
cùng với `Class.GuiObject.TouchPan`. Sự kiện này hữu ích cho
cho phép người chơi manipulate sự xoay của các phần tử UI trên màn hình.

Sự kiện này được kích hoạt với một bảng `Datatype.Vector2` mô tả các
vị trí tương đối trên màn hình của các ngón tay tham gia vào cử chỉ. Ngoài ra,
nó được kích hoạt nhiều lần: `Enum.UserInputState.Begin` sau một
khoảng thời gian ngắn, `Enum.UserInputState.Change` khi người chơi di chuyển một ngón tay
trong cử chỉ, và cuối cùng với `Enum.UserInputState.End`.

GuiObject.TouchRotate

rotation

Một số thực chỉ ra mức độ mà sự xoay đã diễn ra từ điểm bắt đầu của
cử chỉ.

Một số thực chỉ ra tốc độ mà cử chỉ đang được thực hiện.

Kích hoạt khi người chơi thực hiện cử chỉ xoay bằng hai ngón tay trên phần tử
UI.

Mẫu mã này sẽ khiến một `Frame` (hoặc `GuiObject` khác) nhảy lên khi một
cử chỉ vuốt được thực hiện trên thiết bị hỗ trợ cảm ứng (hoặc trình giả lập của Studio).
Các cử chỉ vuốt ngang sẽ thay đổi sắc thái của
`Class.GuiObject.BackgroundColor3`, trong khi các cử chỉ vuốt dọc sẽ thay đổi
độ bão hòa.


Sự kiện này được kích hoạt khi người chơi thực hiện cử chỉ vuốt trên phần tử UI
sử dụng thiết bị hỗ trợ cảm ứng. Nó được kích hoạt với hướng của cử chỉ
(Lên, Xuống, Trái hoặc Phải) và số lượng điểm chạm tham gia
trong cử chỉ. Các cử chỉ vuốt thường được sử dụng để thay đổi tab trong các
UI di động.

GuiObject.TouchSwipe

swipeDirection

Một `Enum.SwipeDirection` chỉ ra hướng của cử chỉ vuốt
(Lên, Xuống, Trái hoặc Phải).

numberOfTouches

Số lượng điểm chạm tham gia trong cử chỉ (thường là 1).

Kích hoạt khi người chơi thực hiện cử chỉ vuốt trên phần tử UI.

Mẫu mã này sẽ chuyển đổi `Class.GuiObject.BackgroundTransparency` của một
phần tử UI, như một `Frame`, khi nó được chạm vào trên một thiết bị có hỗ trợ cảm ứng.

Sự kiện này được kích hoạt khi người chơi thực hiện cử chỉ chạm trên phần tử UI
sử dụng thiết bị hỗ trợ cảm ứng. Một chạm là một lần chạm nhanh đơn lẻ mà không có
sự di chuyển nào (một lần nhấn lâu hơn sẽ kích hoạt
`Class.GuiObject.TouchLongPress`, và di chuyển trong khi chạm sẽ kích hoạt
`Class.GuiObject.TouchPan` và/hoặc `Class.GuiObject.TouchSwipe`). Nó được kích hoạt
với một bảng các đối tượng `Datatype.Vector2` mô tả các vị trí tương đối
của các ngón tay tham gia vào cử chỉ.

GuiObject.TouchTap

Một mảng `Datatype.Vector2` mô tả các vị trí **tương đối**
của các ngón tay tham gia vào cử chỉ.

Kích hoạt khi người chơi thực hiện cử chỉ chạm trên phần tử UI.

Mẫu mã này minh họa một cách sử dụng phức tạp hơn của TweenPosition bằng cách
detecting khi nào tween hoàn thành/hủy bỏ bằng cách định nghĩa một hàm callback. Nó
cũng in ra liệu tween có được phát hay không.


Di chuyển một GUI một cách mượt mà đến một vị trí mới `Datatype.UDim2` trong khoảng thời gian được chỉ định bằng cách sử dụng `Enum.EasingDirection` và `Enum.EasingStyle` được chỉ định.
Phương thức này sẽ phát sinh lỗi nếu `easingStyle` là `Enum.EasingStyle.Bezier` hoặc `Enum.EasingStyle.Spring`.

Hàm này sẽ trả về liệu tween có được phát hay không. Nó sẽ không phát nếu một tween khác đang tác động lên `Class.GuiObject` và tham số override là `false`.

Xem thêm `Class.GuiObject:TweenSize()` và `Class.GuiObject:TweenSizeAndPosition()`.

GuiObject:TweenPosition

endPosition

easingDirection

Hướng mà GUI sẽ được làm mượt đến _endPosition_.

easingStyle

Phong cách mà GUI sẽ được làm mượt đến _endPosition_.

time

Thời gian, tính bằng giây, mà tween nên mất để hoàn thành.

override

Liệu tween có ghi đè một tween đang hoạt động hay không.

callback

Một hàm callback để thực thi khi tween hoàn thành.

Liệu tween có được phát hay không.

Di chuyển một GUI một cách mượt mà đến một `Datatype.UDim2` mới.

Mẫu mã này minh họa cách sử dụng hàm `Class.GuiObject:TweenSize()`
Nó khởi động một hoạt ảnh trên thuộc tính `Class.GuiObject.Size`
của cha để đạt được `UDim2.new(0.5, 0, 0.5, 0)`, tức là một nửa kích thước của `GuiObject`
trên cả hai trục.

Ngoài ra, nó còn minh họa cách tham số callback có thể được sử dụng để phát hiện
khi nào hoạt ảnh dừng lại (dù nó bị hủy bởi một hoạt ảnh khác hay hoàn thành).


Thay đổi kích thước một `Class.GuiObject` một cách mượt mà đến một `Datatype.UDim2` mới trong khoảng thời gian được chỉ định bằng cách sử dụng `Enum.EasingDirection` và `Enum.EasingStyle` được chỉ định. Phương thức này sẽ phát sinh lỗi nếu `easingStyle` là `Enum.EasingStyle.Bezier` hoặc `Enum.EasingStyle.Spring`.

Hàm này sẽ trả về liệu tween có được phát hay không. Thông thường điều này sẽ luôn trả về `true`, nhưng nó sẽ trả về `false` nếu một tween khác đang hoạt động và override được đặt thành `false`.

Xem thêm `Class.GuiObject:TweenSize()` và `Class.GuiObject:TweenSizeAndPosition()`.

GuiObject:TweenSize

endSize

Hướng mà GUI sẽ được làm mượt đến _endSize_.

Phong cách mà GUI sẽ được làm mượt đến _endSize_.

Thay đổi kích thước một `Class.GuiObject` một cách mượt mà đến một `Datatype.UDim2` mới.

Ví dụ dưới đây sẽ chuyển đổi một `Class.Frame` đến góc trên bên trái của kích thước cha và thay đổi kích thước nó xuống 0.


Thay đổi kích thước và di chuyển một GUI một cách mượt mà đến một kích thước và vị trí mới `Datatype.UDim2` trong khoảng thời gian được chỉ định bằng cách sử dụng `Enum.EasingDirection` và `Enum.EasingStyle` được chỉ định. Phương thức này sẽ phát sinh lỗi nếu `easingStyle` là `Enum.EasingStyle.Bezier` hoặc `Enum.EasingStyle.Spring`.

Hàm này sẽ trả về liệu tween có được phát hay không. Thông thường điều này sẽ luôn trả về `true`, nhưng nó sẽ trả về `false` nếu một tween khác đang hoạt động và override được đặt thành `false`.

Xem thêm `Class.GuiObject:TweenSize()` và `Class.GuiObject:TweenSizeAndPosition()`.

GuiObject:TweenSizeAndPosition

Hướng mà GUI sẽ được làm mượt đến _endSize_ và _endPosition_.

Phong cách mà GUI sẽ được làm mượt đến _endSize_ và _endPosition_.

Di chuyển một GUI một cách mượt mà đến một kích thước và vị trí mới.

GuiObject

Mẫu mã này minh họa cách sử dụng thuộc tính Active như một bộ lùi
cho sự kiện Activated.

Thuộc tính này xác định xem `Class.GuiObject` có nhận đầu vào vào không gian 3D hay không, chẳng hạn như các mô hình bên dưới với lớp `Class.ClickDetector` như `Class.DragDetector`.

Đối với các đối tượng `Class.GuiButton` (`Class.ImageButton` và `Class.TextButton`), thuộc tính này xác định xem `Class.GuiButton.Activated|Activated` có được kích hoạt hay không (`Class.GuiButton.AutoButtonColor|AutoButtonColor` vẫn sẽ hoạt động cho những đối tượng đó). Các sự kiện `Class.GuiObject.InputBegan|InputBegan`, `Class.GuiObject.InputChanged|InputChanged`, và `Class.GuiObject.InputEnded|InputEnded` hoạt động bình thường bất kể giá trị của thuộc tính này.

GuiObject.Active

Xác định xem phần tử UI này có nhận đầu vào hay không.

Mẫu mã này di chuyển một phần tử UI đến các cạnh khác nhau của phần tử cha.
Nó bắt đầu ở góc trên bên trái và kết thúc ở góc dưới bên phải. Dán vào một
LocalScript trong một Frame, trong một ScreenGui.


Thuộc tính này xác định điểm gốc của một `Class.GuiObject`, tương đối với kích thước tuyệt đối của nó. Điểm gốc xác định từ đâu phần tử được định vị (thông qua `Class.GuiObject.Position`) và từ đâu kích thước `Class.GuiObject.Size` được mở rộng.

Xem [tại đây](/ui/position-and-size#anchorpoint) để biết các sơ đồ minh họa và chi tiết.

GuiObject.AnchorPoint

Xác định điểm gốc của một `Class.GuiObject`, tương đối với kích thước tuyệt đối của nó.

Đoạn mã sau tạo ra một khung cha tự động có kích thước với
a `UIListLayout`, sau đó nó chèn một số đối tượng `TextLabel`
được tự động kích thước. Lưu ý rằng `UIListLayout` cha tự động thay đổi kích thước để phù hợp với
nội dung con của nó và các nhãn tự động thay đổi kích thước để phù hợp với nội dung văn bản của chúng.
Đoạn mã này có thể được gán cho một `ScreenGui`.


Thuộc tính này được sử dụng để tự động điều chỉnh kích thước các đối tượng UI cha dựa trên kích thước của các đối tượng con của nó. Bạn có thể sử dụng thuộc tính này để thêm văn bản và nội dung khác vào một đối tượng UI một cách động tại thời điểm chỉnh sửa hoặc chạy, và kích thước sẽ điều chỉnh để phù hợp với nội dung đó.

Khi `Class.GuiObject.AutomaticSize|AutomaticSize` được đặt thành một giá trị `Enum.AutomaticSize` khác với `Enum.AutomaticSize|None`, đối tượng UI này có thể thay đổi kích thước tùy thuộc vào nội dung con của nó.

Để biết thêm thông tin về cách sử dụng thuộc tính này và cách nó hoạt động, vui lòng xem [tại đây](/ui/size-modifiers#automatic-sizing).

GuiObject.AutomaticSize

Xác định xem việc thay đổi kích thước có xảy ra dựa trên nội dung con hay không.

Xác định màu nền của `Class.GuiObject`.

GuiObject.BackgroundColor

Mẫu mã này khiến một khung cha lặp qua tất cả các màu của
cầu vồng bằng cách sử dụng Color3.fromHSV.


Thuộc tính này xác định màu nền của một `Class.GuiObject` (màu nền). Nếu phần tử của bạn chứa văn bản, chẳng hạn như `Class.TextBox`, `Class.TextButton`, hoặc `Class.TextLabel`, hãy đảm bảo rằng màu nền của bạn tương phản với màu của văn bản.

Một thuộc tính khác xác định các thuộc tính hình ảnh của nền là `Class.GuiObject.BackgroundTransparency`; nếu thuộc tính này được đặt thành `1`, cả nền và viền sẽ không được hiển thị.

Xem thêm `Class.GuiObject.BorderColor3|BorderColor3`.

GuiObject.BackgroundColor3

Thuộc tính này xác định độ trong suốt của nền và viền của `Class.GuiObject`. Tuy nhiên, nó không xác định độ trong suốt của văn bản nếu GUI là một `Class.TextBox`, `Class.TextButton`, hoặc `Class.TextLabel`; độ trong suốt của văn bản được xác định bởi `Class.TextBox.TextTransparency`, `Class.TextButton.TextTransparency`, và `Class.TextLabel.TextTransparency` tương ứng.

Nếu thuộc tính này được đặt thành `1`, cả nền và viền sẽ không được hiển thị và nền GUI sẽ hoàn toàn trong suốt.

GuiObject.BackgroundTransparency

Xác định độ trong suốt của nền và viền của `Class.GuiObject`.

Xác định màu viền của `Class.GuiObject`.

GuiObject.BorderColor

Mẫu mã này làm cho viền của một GuiObject cha nổi bật khi người dùng di chuột qua phần tử.


Xác định màu viền hình chữ nhật của `Class.GuiObject` (còn được gọi là màu viền). Điều này tách biệt với `Class.GuiObject.BackgroundColor3`. Bạn sẽ không thể nhìn thấy viền của đối tượng nếu thuộc tính `Class.GuiObject.BorderSizePixel` được đặt thành `0`.

Lưu ý rằng thành phần `Class.UIStroke` cho phép các hiệu ứng viền nâng cao hơn.

GuiObject.BorderColor3

Thuộc tính này xác định cách mà viền của `Class.GuiObject` được bố trí tương đối với kích thước của nó bằng cách sử dụng enum cùng tên, `Enum.BorderMode`.

Lưu ý rằng `Class.UIStroke` có thể ghi đè thuộc tính này và cho phép các hiệu ứng viền nâng cao hơn.

GuiObject.BorderMode

Xác định cách mà viền của `Class.GuiObject` được bố trí tương đối với kích thước của nó.

Thuộc tính này xác định độ rộng của viền `Class.GuiObject`, tính bằng pixel. Đặt giá trị này thành 0 sẽ vô hiệu hóa hoàn toàn viền.

Lưu ý rằng `Class.UIStroke` có thể ghi đè thuộc tính này và cho phép các hiệu ứng viền nâng cao hơn.

GuiObject.BorderSizePixel

Xác định độ rộng pixel của viền `Class.GuiObject`.

Thuộc tính này xác định xem `Class.GuiObject` có cắt (làm cho vô hình) bất kỳ phần nào của các phần tử GUI con mà sẽ hiển thị bên ngoài giới hạn của hình chữ nhật hay không.

#### Hành vi xoay

Khi `Class.StarterGui.ClipsDescendantsSupportsRotation` được bật, việc cắt sẽ hoạt động chính xác cho các hình dạng đã xoay. Tuy nhiên, việc cắt **bởi** các hình dạng đã xoay (khi chính phần tử cắt cũng đã xoay) hoặc bởi các góc tròn (`Class.UICorner`) không được hỗ trợ.

Khi `Class.StarterGui.ClipsDescendantsSupportsRotation` **không** được bật và `Class.GuiObject` này hoặc bất kỳ `Class.GuiObject` tổ tiên nào có `Class.GuiObject.Rotation|Rotation` **khác không**, thuộc tính này sẽ bị **bỏ qua** và các phần tử GUI con sẽ được hiển thị bất kể giá trị của thuộc tính này.

GuiObject.ClipsDescendants

Xác định xem các `Class.GuiObject|GuiObjects` con nằm ngoài giới hạn của một phần tử GUI cha có nên được hiển thị hay không.

Điều này cho biết liệu một `Class.GuiObject` (và các phần tử con của nó) có thể được kéo quanh màn hình hay không.

GuiObject.Draggable

Xác định xem một `Class.GuiObject` (và các phần tử con của nó) có thể được kéo quanh màn hình hay không.

Khi ngón tay của người chơi đang được chạm và giữ trên `Class.GuiObject`, `Class.GuiObject.GuiState|GuiState` của `Class.GuiObject` sẽ được đặt thành `Enum.GuiState.Press|Press`. Tương tự, khi ngón tay của người chơi được thả ra khỏi `Class.GuiObject`, `Class.GuiObject.GuiState|GuiState` của `Class.GuiObject` sẽ được đặt thành `Enum.GuiState.Idle|Idle`, và khi `Class.GuiObject.Interactable|Interactable` bị tắt trên `Class.GuiObject`, `Class.GuiState` của `Class.GuiObject` sẽ được đặt thành `Enum.GuiState.NonInteractable|NonInteractable`.

GuiObject.GuiState

Xác định xem chuột của người chơi có đang được nhấn xuống trên `Class.GuiObject` hay không.

Kiểm soát xem, và ở mức độ nào, `Class.GuiObject` nhận đầu vào xảy ra trên nó, sử dụng `Enum.InputSink`. Việc nhận đầu vào ngăn nó không truyền qua các đối tượng phía sau phần tử, bao gồm các đối tượng 3D trong thế giới như những đối tượng có `Class.ClickDetector` hoặc `Class.DragDetector`. Mặc định là `Enum.InputSink.None`, ngoại trừ trên các đối tượng `Class.GuiButton` (`Class.ImageButton` và `Class.TextButton`), nơi mặc định là `Enum.InputSink.Activate`.

- `Enum.InputSink.None` — đối tượng không nhận đầu vào của riêng nó.
- `Enum.InputSink.Activate` — đối tượng nhận đầu vào nhấn nút chuột và chạm để kích hoạt nó, nhưng cho phép đầu vào khác (chẳng hạn như di chuyển chuột) đi qua.
- `Enum.InputSink.All` — đối tượng nhận tất cả đầu vào xảy ra trên nó.

Thuộc tính này là một kế thừa chi tiết hơn của thuộc tính boolean `Class.GuiObject.Active|Active`, chỉ có thể nhận tất cả đầu vào hoặc không có đầu vào nào. Các sự kiện `Class.GuiObject.InputBegan|InputBegan`, `Class.GuiObject.InputChanged|InputChanged`, và `Class.GuiObject.InputEnded|InputEnded` sẽ được kích hoạt bất kể giá trị của thuộc tính này.

GuiObject.InputSink

Kiểm soát xem, và như thế nào, `Class.GuiObject` nhận đầu vào xảy ra trên nó.

Xác định xem `Class.GuiButton` có thể tương tác hay không, hoặc nếu `Enum.GuiState|GuiState` của `Class.GuiObject` đang thay đổi hay không.

Trên một `Class.GuiButton`:

- Khi cài đặt `Class.GuiObject.Interactable|Interactable` trên `Class.GuiButton` được đặt thành `false`, `Class.GuiButton` sẽ không còn có thể được nhấn hoặc nhấp, và `Class.GuiObject.GuiState|GuiState` sẽ luôn được đặt thành `Enum.GuiState.NonInteractable|NonInteractable`.
- Khi cài đặt `Class.GuiObject.Interactable|Interactable` trên `Class.GuiButton` được đặt thành `true`, `Class.GuiButton` sẽ hoạt động bình thường trở lại và `Class.GuiObject.GuiState|GuiState` sẽ hoạt động bình thường.

Trên một `Class.GuiObject`:

- Khi cài đặt `Class.GuiObject.Interactable|Interactable` trên `Class.GuiButton` được đặt thành `false`, `Class.GuiObject.GuiState|GuiState` sẽ luôn được đặt thành `Enum.GuiState.NonInteractable|NonInteractable`.
- Khi cài đặt `Class.GuiObject.Interactable|Interactable` trên `Class.GuiButton` được đặt thành `true`, `Class.GuiObject.GuiState|GuiState` sẽ hoạt động bình thường trở lại.

GuiObject.Interactable

Xác định xem `Class.GuiButton` có thể tương tác hay không, hoặc nếu `Enum.GuiState|GuiState` của `Class.GuiObject` đang thay đổi hay không.

Thuộc tính này kiểm soát thứ tự sắp xếp của `Class.GuiObject` khi sử dụng `Class.UIGridStyleLayout` (chẳng hạn như `Class.UIListLayout` hoặc `Class.UIPageLayout`) với `Class.UIGridStyleLayout.SortOrder|SortOrder` được đặt thành `Enum.SortOrder.LayoutOrder`. Nó không có chức năng nếu đối tượng không có cấu trúc bố cục UI anh em.

`Class.GuiObject|GuiObjects` được sắp xếp theo thứ tự tăng dần, trong đó các giá trị thấp hơn có ưu tiên hơn các giá trị cao hơn. Các đối tượng có giá trị bằng nhau sẽ quay lại thứ tự mà chúng được thêm vào.

Nếu bạn không chắc chắn liệu bạn có cần thêm một phần tử giữa hai phần tử hiện có trong tương lai hay không, thì việc sử dụng các bội số của `100` (`0`, `100`, `200`, v.v.) là một thực tiễn tốt. Điều này đảm bảo một khoảng cách lớn giữa các giá trị thứ tự bố cục mà bạn có thể sử dụng cho các phần tử được sắp xếp giữa các phần tử khác.

Xem thêm `Class.GuiObject.ZIndex|ZIndex` xác định thứ tự **hiển thị** của đối tượng thay vì thứ tự sắp xếp.

GuiObject.LayoutOrder

Kiểm soát thứ tự sắp xếp của `Class.GuiObject` khi được sử dụng với `Class.UIGridStyleLayout`.

Ví dụ này minh họa cách kích hoạt điều hướng Gamepad qua một lưới các
`GuiObject|GUI` mà không cần phải kết nối thủ công các
`Class.GuiObject.NextSelectionUp`, `Class.GuiObject.NextSelectionDown`, và
`GuiObject|NextSelectionRight`, và `Class.GuiObject.NextSelectionLeft`
cho từng phần tử trong lưới.

Lưu ý rằng ví dụ mã này giả định rằng `UIGridLayout` của bạn được sắp xếp theo
`Class.UIGridLayout.SortOrder|name`, trong đó các phần tử được đặt tên theo thứ tự số liên tiếp.

Mã này dựa vào điều này để thiết lập các thuộc tính NextSelection cho tất cả
`GuiObjects` ở cùng cấp với UIGridLayout. Trong ví dụ của chúng tôi, đối tượng
UIGridLayout và các phần tử GUI trong lưới đều là con của một
`Frame` có tên _"Container"_. Mã
`Class.Instance:GetChildren()|lấy các con` của _"Container"_ và lặp qua từng con.
Các con không phải là GuiObjects sẽ bị bỏ qua. Đối với mỗi phần tử GUI,
mã cố gắng gán các thuộc tính NextSelection bằng cách sử dụng logic sau:

1. Bắt đầu với 1, tên của tất cả các phần tử GUI khớp với vị trí của chúng trong lưới
2. Trái: Mục bên trái sẽ luôn được đánh số nhỏ hơn 1 so với phần tử hiện tại
3. Phải: Mục bên phải sẽ luôn được đánh số lớn hơn 1 so với phần tử hiện tại
4. Lên: Mục phía trên (lên) sẽ luôn là số của GUIs trong một hàng nhỏ hơn 1 so với phần tử hiện tại
5. Xuống: Mục phía dưới (xuống) sẽ luôn là số của GUIs trong một hàng lớn hơn so với phần tử hiện tại. Logic này cũng cho phép các phần tử GUI ở
   đầu và cuối của hàng (không bao gồm phần tử đầu tiên và cuối cùng) quay lại
   hàng tiếp theo và trước đó. Nếu một phần tử không tồn tại bên trái, bên phải,
   phía trên, hoặc phía dưới, NextSelection sẽ vẫn là nil và việc di chuyển bộ chọn
   Gamepad theo hướng đó sẽ không thay đổi GUI được chọn.

Ví dụ này cũng chứa mã để kiểm tra lưới bằng cách sử dụng các phím mũi tên (Lên,
Xuống, Trái, Phải) trên bàn phím của bạn thay vì một gamepad, chỉ trong trường hợp bạn
không có gamepad để thử nghiệm. Phần mã này ban đầu chọn phần tử có tên _"1"_
bằng cách gán nó cho thuộc tính `Class.GuiService.SelectedObject`.


Thuộc tính này đặt `Class.GuiObject` được chọn khi người dùng di chuyển bộ chọn [gamepad](/input/gamepad) xuống. Nếu thuộc tính này trống, việc di chuyển gamepad xuống sẽ không thay đổi GUI được chọn.

Di chuyển bộ chọn gamepad xuống sẽ đặt `Class.GuiService.SelectedObject` thành đối tượng này trừ khi GUI không phải là `Class.GuiObject.Selectable|Selectable`. Lưu ý rằng thuộc tính này có thể được đặt thành một phần tử GUI ngay cả khi nó không phải là `Class.GuiObject.Selectable|Selectable`, vì vậy bạn nên đảm bảo rằng giá trị của thuộc tính có thể chọn của GUI phù hợp với hành vi mong đợi của bạn.

Xem thêm `Class.GuiObject.NextSelectionUp|NextSelectionUp`, `Class.GuiObject.NextSelectionLeft|NextSelectionLeft`, và `Class.GuiObject.NextSelectionRight|NextSelectionRight`.

GuiObject.NextSelectionDown

Đặt `Class.GuiObject` sẽ được chọn khi bộ chọn gamepad được di chuyển xuống.

Thuộc tính này đặt `Class.GuiObject` được chọn khi người dùng di chuyển bộ chọn [gamepad](/input/gamepad) sang trái. Nếu thuộc tính này trống, việc di chuyển gamepad sang trái sẽ không thay đổi GUI được chọn.

Di chuyển bộ chọn gamepad sang trái sẽ đặt `Class.GuiService.SelectedObject` thành đối tượng này trừ khi GUI không phải là `Class.GuiObject.Selectable|Selectable`. Lưu ý rằng thuộc tính này có thể được đặt thành một phần tử GUI ngay cả khi nó không phải là `Class.GuiObject.Selectable|Selectable`, vì vậy bạn nên đảm bảo rằng giá trị của thuộc tính có thể chọn của GUI phù hợp với hành vi mong đợi của bạn.

Xem thêm `Class.GuiObject.NextSelectionUp|NextSelectionUp`, `Class.GuiObject.NextSelectionDown|NextSelectionDown`, và `Class.GuiObject.NextSelectionRight|NextSelectionRight`.

GuiObject.NextSelectionLeft

Đặt `Class.GuiObject` sẽ được chọn khi bộ chọn gamepad được di chuyển sang trái.

Một lớp trừu tượng cho tất cả các đối tượng giao diện người dùng 2D.

/reference/engine/classes/TextChannelWindow.yaml

Tóm tắt