`InputActionLabel` là một `Class.GuiObject` kéo và thả tự động
hiển thị phím hoặc biểu tượng phù hợp cho một `Class.InputAction` dựa trên
thiết bị đầu vào hiện tại của người chơi (bàn phím/chuột, tay cầm, cảm ứng, VR). Khi người chơi chuyển đổi thiết bị hoặc gán lại phím, nhãn sẽ cập nhật ngay lập tức
mà không cần lập trình.

Việc hiển thị của `InputActionLabel` phụ thuộc vào `Class.InputAction` (liên kết
thông qua `Class.InputActionLabel.InputAction`) và các `Class.InputBinding|InputBindings` con của hành động đó. Khi nhãn xác định những gì để hiển thị, nó
tuân theo thứ tự này:

1. **Hình ảnh tùy chỉnh** — Nếu các `Class.InputBinding|InputBindings` con có
   thuộc tính `Class.InputBinding.DisplayImage|DisplayImage` được thiết lập, nhãn
   sẽ hiển thị những hình ảnh đó trực tiếp, có thể được điều chỉnh bởi
   `Class.InputActionLabel.ImageColor3|ImageColor3` và
   `Class.InputActionLabel.ImageTransparency|ImageTransparency`.

2. **Hình ảnh phím nền tảng** — Nếu không có hình ảnh tùy chỉnh, nhãn sẽ hiển thị
   hình ảnh do nền tảng cung cấp cho các `Class.InputBinding|InputBindings`
   thông qua `Class.UserInputService:GetImageForKeyCode()`, nếu có hình ảnh như vậy.
   Các gán kết hợp với các bộ điều chỉnh sẽ hiển thị nhiều biểu tượng với các ký tự `+`
   phân cách.

3. **Tên tùy chỉnh** — Nếu không có hình ảnh nào có sẵn, nếu các `Class.InputBinding|InputBindings` con có
   thuộc tính `Class.InputBinding.DisplayName|DisplayName` được thiết lập, nhãn
   sẽ hiển thị văn bản đó theo kiểu được xác định bởi
   `Class.InputActionLabel.FontFace|FontFace`,
   `Class.InputActionLabel.TextColor3|TextColor3`,
   `Class.InputActionLabel.TextSize|TextSize`,
   `Class.InputActionLabel.TextTransparency|TextTransparency`,
   `Class.InputActionLabel.TextWrapped|TextWrapped`,
   `Class.InputActionLabel.TextXAlignment|TextXAlignment`, và
   `Class.InputActionLabel.TextYAlignment|TextYAlignment`.

4. **Chuỗi phím nền tảng** — Nếu không có tất cả các tùy chọn trên, nhãn sẽ hiển thị
   các chuỗi do nền tảng cung cấp thông qua
   `Class.UserInputService:GetStringForKeyCode()`.

5. Nếu không có `Class.InputAction` nào được gán hoặc không có `Class.InputBinding`
   con nào tồn tại, nhãn sẽ hiển thị một biểu tượng giữ chỗ.


InputActionLabel

Thuộc tính này tương tự như `Class.TextLabel.FontFace` và xác định
họ phông, trọng lượng và kiểu được sử dụng khi nhãn hiển thị ở chế độ văn bản.


InputActionLabel.FontFace

Xác định phông chữ được sử dụng để hiển thị văn bản.


Thuộc tính này xác định cách các hình ảnh nhãn được tô màu. Khi được thiết lập thành
màu trắng, không có sự tô màu nào xảy ra. Thuộc tính này hữu ích cho việc tái sử dụng tài sản hình ảnh; nếu các hình ảnh nguồn hoàn toàn màu trắng với độ trong suốt, bạn
có thể thiết lập toàn bộ màu nhãn cùng một lúc với thuộc tính này.


InputActionLabel.ImageColor3

Xác định cách các hình ảnh nhãn được tô màu.


Thuộc tính này xác định độ alpha của các hình ảnh nhãn được hiển thị. Giá trị `0` là hoàn toàn không trong suốt và giá trị `1` là hoàn toàn trong suốt
(không nhìn thấy).


InputActionLabel.ImageTransparency

Xác định độ trong suốt của các hình ảnh nhãn được hiển thị.


Thể hiện `Class.InputAction` mà nhãn tự động xác định và hiển thị gán kết ưa thích của nó. Khi gán kết thay đổi (do gán lại hoặc chuyển đổi thiết bị đầu vào), nhãn sẽ tự động cập nhật.

Thiết lập điều này thành `nil` sẽ xóa hiển thị và hiển thị biểu tượng giữ chỗ.


InputActionLabel.InputAction

`Class.InputAction` mà gán kết ưa thích của nhãn này hiển thị.


Chứa `Datatype.Content` của hình ảnh đã được xác định đầu tiên khi nhãn
hiển thị ở chế độ hình ảnh. Trống khi ở chế độ văn bản hoặc giữ chỗ. Đây là
một thuộc tính chỉ đọc được thiết lập bởi engine khi gán kết được xác định.


InputActionLabel.ResolvedImageContent

Chỉ đọc. Nội dung hình ảnh đã được xác định hiện đang được hiển thị.


Chứa chuỗi tên phím được tạo thành như `Ctrl + Shift + Space` khi
nhãn hiển thị ở chế độ văn bản. Trống khi nhãn hiển thị ở chế độ hình ảnh hoặc
giữ chỗ. Đây là một thuộc tính chỉ đọc được thiết lập bởi engine khi gán kết
được xác định.


InputActionLabel.ResolvedText

Chuỗi tên phím đã được xác định hiện đang được hiển thị.


Thuộc tính này xác định màu sắc của tất cả văn bản được hiển thị bởi nhãn.


InputActionLabel.TextColor3

Xác định màu sắc của văn bản được hiển thị.


Kiểm soát kích thước phông chữ tính bằng pixel cho việc hiển thị ở chế độ văn bản. Giá trị được giới hạn
giữa `1` và `200`.


InputActionLabel.TextSize

Xác định chiều cao dòng của văn bản trong các khoảng cách.


Thuộc tính này xác định độ trong suốt của tất cả văn bản được hiển thị bởi
nhãn.


InputActionLabel.TextTransparency

Xác định độ trong suốt của văn bản được hiển thị.


Khi `true`, văn bản được hiển thị trên nhiều dòng trong không gian của nhãn để
`Class.InputActionLabel.TextSize|TextSize` không bao giờ vượt quá
`Class.GuiBase2d.AbsoluteSize` của đối tượng. Điều này đạt được bằng cách chia
các dòng văn bản dài thành nhiều dòng.


InputActionLabel.TextWrapped

Xác định xem văn bản có được bọc thành nhiều dòng trong không gian của nhãn hay không.


Thuộc tính này xác định căn chỉnh ngang của văn bản được hiển thị trong
không gian của nhãn.


InputActionLabel.TextXAlignment

Xác định căn chỉnh ngang của văn bản được hiển thị.


Thuộc tính này xác định căn chỉnh dọc của văn bản được hiển thị trong
không gian của nhãn.


InputActionLabel.TextYAlignment

Xác định căn chỉnh dọc của văn bản được hiển thị.


Một `Class.GuiObject` tự động hiển thị phím tắt cho một hành động
dưới dạng văn bản hoặc hình ảnh.


`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ị
của 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 vượt ra 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 một 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 một
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 một
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`.

Vui lòng khô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 là 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 mà 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`.

Vui lòng khô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 là 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 mà 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.

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ử `Class.GuiObject`. Nó tương tự như `Class.Mouse.Move`, 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.

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 lặp đi lặp lại trong khi đang di chuyển.

Các tham số `x` và `y` chỉ ra tọa độ màn hình đã cập nhật của chuột người dùng tính bằng pixel. Những điều 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 tương đối với một phần tử 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)
```
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 rời 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 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ọ về phía sau
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ọ về phía sau 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

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

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 đầu cử chỉ (sau 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 của họ trong khi nhấn xuống
- End được kích hoạt một lần tại cuối cử chỉ khi họ thả ngón tay của họ.

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 của họ trên phần tử UI
bằng thiết bị hỗ trợ chạm. Nó được kích hoạt ngay trước khi
`Class.GuiObject.TouchSwipe` sẽ, 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 thao tác 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í 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` khi người chơi di chuyển ngón tay của họ trong suốt 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
dimension.

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

Kích hoạt khi người chơi di chuyển ngón tay của họ 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 bằng một 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 việc 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 zoom.

Sự kiện này đượ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,
sự kiện này được kích hoạt nhiều lần: `Enum.UserInputState.Begin` sau một
thời gian ngắn, `Enum.UserInputState.Change` khi người chơi di chuyển một ngón tay
trong quá trình 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ừ đầu 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 bằng một 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
việc cho phép người chơi manipulate 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í màn hình tương đối của các ngón tay tham gia vào cử chỉ. Ngoài ra,
sự kiện này được kích hoạt nhiều lần: `Enum.UserInputState.Begin` sau một
thời gian ngắn, `Enum.UserInputState.Change` khi người chơi di chuyển một ngón tay
trong quá trình cử chỉ, và cuối cùng với `Enum.UserInputState.End`.

GuiObject.TouchRotate

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ỉ.

rotation

Một số thực chỉ ra mức độ mà cử chỉ xoay đã đi 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
bằng một thiết bị hỗ trợ cảm ứng. Nó được kích hoạt với hướng của cử chỉ
(Trên, Dưới, 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
(Trên, Dưới, 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
bằng một 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 quá trình 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

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í `Datatype.UDim2` mới trong thời gian chỉ định bằng cách sử dụng `Enum.EasingDirection` và `Enum.EasingStyle` đã chỉ định.

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 hoạt động trên `Class.GuiObject` và tham số ghi đè 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 sẽ 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 thời gian chỉ định bằng cách sử dụng `Enum.EasingDirection` và
`Enum.EasingStyle` đã chỉ định.

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à ghi đè đượ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í `Datatype.UDim2` mới trong thời gian chỉ định bằng cách sử dụng `Enum.EasingDirection`
và `Enum.EasingStyle` đã chỉ định.

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à ghi đè đượ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,
như các mô hình bên dưới với lớp `Class.ClickDetector`
hay `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 `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
`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 `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 trong thời gian 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 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`,
không có nền hay viền nào sẽ đượ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à `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`, không có nền hay viền nào sẽ đượ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 bố trí viền của `Class.GuiObject` 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 bố trí viền của `Class.GuiObject` 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`.

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/InputActionLabel.yaml