`Class.GuiButton` là một lớp trừu tượng kế thừa từ `Class.GuiObject`.
Nó là lớp cơ sở cho các đối tượng tương tác, có thể nhấp `Class.ImageButton` và
`Class.TextButton`. Lớp này cũng xác định một số thuộc tính cho
hành vi tương tác, cụ thể là `Class.GuiButton.AutoButtonColor|AutoButtonColor`
và `Class.GuiButton.Modal|Modal`.

Sự kiện quan trọng nhất của `Class.GuiButton` là
`Class.GuiButton.Activated|Activated`, một **sự kiện đa nền tảng** xảy ra
khi nút được kích hoạt. Khi sử dụng chuột, điều này có nghĩa là nhấp vào
nút và thả ra khi con trỏ vẫn nằm trên đối tượng UI. Đối với cảm ứng, điều
này cũng áp dụng nhưng với một lần chạm thay vì nhấn nút. Cuối cùng, đối với các
gamepad, `Class.GuiButton.Activated|Activated` xảy ra nếu một `Class.GuiButton`
bị chọn khi nút **A** được nhấn và thả. Tóm lại, sự kiện này rất
hữu ích cho lập trình giao diện người dùng đa nền tảng vì cung cấp một giao diện
chung đẹp cho một đầu vào của người dùng duy nhất.

Sự kiện này được kích hoạt khi phát hiện nhấn và thả chuột trái trên máy tính để bàn, hoặc phát hiện thả chạm trên di động, hoặc **A**/nút chéo được kích hoạt trong chế độ điều hướng UI trên console.

Vì sự kiện này không được kích hoạt trên máy chủ, nó chỉ nên được sử dụng trong một `Class.LocalScript`, hoặc trong một `Class.Script` với `Class.Script.RunContext|RunContext` là `Enum.RunContext.Client`.

GuiButton.Activated

inputObject

clickCount

Sự kiện này xảy ra khi chuột của người dùng hoàn toàn nhấp trái
vào `Class.GuiButton`.

Về việc nhấp, chuột phải ở trong vùng của
`Class.GuiButton` và nút chuột phải phải được nhấn xuống và thả ra trước khi sự kiện này xảy ra. Nếu chuột rời khỏi vùng của
`Class.GuiButton` và được thả ra, sự kiện sẽ không xảy ra. Nếu bạn muốn tránh giới hạn này, bạn có thể sử dụng
`Class.GuiButton.MouseButton1Down|MouseButton1Down` và
`Class.GuiButton.MouseButton1Up|MouseButton1Up`; những sự kiện này tương tự
nhưng sẽ xảy ra bất cứ khi nào người dùng nhấn nút chuột trái xuống hoặc
thả ra, tương ứng.

GuiButton.MouseButton1Click

Xảy ra khi chuột của người dùng hoàn toàn nhấp trái vào `Class.GuiButton`.

Sự kiện này xảy ra khi người dùng nhấn nút chuột trái xuống trên
`Class.GuiButton`.

Đối với một sự kiện yêu cầu người dùng nhấn **và** thả nút chuột trái
trên `Class.GuiButton` để sự kiện xảy ra, hãy xem xét sử dụng
`Class.GuiButton.MouseButton1Click|MouseButton1Click`.

GuiButton.MouseButton1Down

Tọa độ màn hình **X** của chuột tính bằng pixel.

Tọa độ màn hình **Y** của chuột tính bằng pixel.

Xảy ra khi người dùng nhấn nút chuột trái xuống trên
`Class.GuiButton`.

Sự kiện này xảy ra khi người dùng thả nút chuột trái ra khỏi
`Class.GuiButton`.

Đối với một sự kiện yêu cầu người dùng nhấn **và** thả nút chuột trái
trên `Class.GuiButton` để sự kiện xảy ra, hãy xem xét sử dụng
`Class.GuiButton.MouseButton1Click|MouseButton1Click`.

GuiButton.MouseButton1Up

Xảy ra khi người dùng thả nút chuột trái ra khỏi
`Class.GuiButton`.

Sự kiện này xảy ra khi chuột của người dùng hoàn toàn nhấp phải
vào `Class.GuiButton`.

Về việc nhấp, chuột phải ở trong vùng của
`Class.GuiButton` và nút chuột phải phải được nhấn xuống và thả ra trước khi sự kiện này xảy ra. Nếu chuột rời khỏi vùng của
`Class.GuiButton` và được thả ra, sự kiện sẽ không xảy ra. Nếu bạn muốn tránh giới hạn này, bạn có thể sử dụng
`Class.GuiButton.MouseButton2Down|MouseButton2Down` và
`Class.GuiButton.MouseButton2Up|MouseButton2Up`; những sự kiện này tương tự
nhưng sẽ xảy ra bất cứ khi nào người dùng nhấn nút chuột phải xuống hoặc
thả ra, tương ứng.

GuiButton.MouseButton2Click

Xảy ra khi chuột của người dùng hoàn toàn nhấp phải vào `Class.GuiButton`.

Sự kiện này xảy ra khi người dùng nhấn nút chuột phải xuống trên
the `Class.GuiButton`.

Đối với một sự kiện yêu cầu người dùng nhấn **và** thả nút chuột phải
trên `Class.GuiButton` để sự kiện xảy ra, hãy xem xét sử dụng
`Class.GuiButton.MouseButton2Click|MouseButton2Click`.

GuiButton.MouseButton2Down

Xảy ra khi người dùng nhấn nút chuột phải xuống trên
`Class.GuiButton`.

Sự kiện này xảy ra khi người dùng thả nút chuột phải ra khỏi
`Class.GuiButton`.

Đối với một sự kiện yêu cầu người dùng nhấn **và** thả nút chuột phải
trên `Class.GuiButton` để sự kiện xảy ra, hãy xem xét sử dụng
`Class.GuiButton.MouseButton2Click|MouseButton2Click`.

GuiButton.MouseButton2Up

Xảy ra khi người dùng thả nút chuột phải ra khỏi
`Class.GuiButton`.

Xảy ra khi phát hiện một cú nhấp chuột phải và thả ra từ chuột, phát hiện một cú nhấn lâu trên đầu vào cảm ứng, `R3` được phát hiện từ tay cầm trò chơi, hoặc
<kbd>Alt</kbd><kbd>Enter</kbd> được phát hiện trong chế độ điều hướng UI sử dụng
bàn phím.


GuiButton.SecondaryActivated

Đối tượng đầu vào đại diện cho hành động kích hoạt thay thế.

Kích hoạt khi đầu vào "thứ cấp" của nút được kích hoạt.

GuiButton

Thuộc tính này xác định xem nút có tự động thay đổi màu
khi `Class.Mouse` của người dùng di chuyển qua hoặc nhấp vào nó hay không. Nếu `true`, nút sẽ tự động thay đổi màu khi chuột di chuyển qua hoặc
nhấp vào nó. Nếu `false`, nút sẽ không thay đổi.

Nếu bạn muốn tùy chỉnh cách nút thay đổi khi chuột của người dùng
di chuyển qua hoặc nhấp vào nó, hãy xem xét việc sử dụng `Class.ImageButton` và
thay đổi thuộc tính `Class.ImageButton.HoverImage|HoverImage` và
`Class.ImageButton.PressedImage|PressedImage` của phần tử.

Xin lưu ý rằng thuộc tính này sẽ không có tác dụng trên một
`Class.ImageButton` nếu thuộc tính `Class.ImageButton.Image|Image` của nó được đặt
là một hình ảnh. Ngoài ra, thuộc tính này sẽ không ảnh hưởng đến
`Class.ImageButton` khi di chuột qua nếu thuộc tính
`Class.ImageButton.HoverImage|HoverImage` của nó không phải là `nil`, cũng như khi nhấp chuột
nếu thuộc tính `Class.ImageButton.PressedImage|PressedImage` của nó không phải là `nil`.

GuiButton.AutoButtonColor

Xác định xem nút có tự động thay đổi màu khi chuột
di chuyển qua hoặc nhấp vào nó hay không.

Một thể hiện `Class.HapticEffect` sẽ phát khi `Class.GuiButton`
bị di chuột qua.

GuiButton.HoverHapticEffect

Nếu `true` khi phần tử GUI hiển thị, chuột sẽ không bị khóa
trừ khi nút chuột phải được giữ.

GuiButton.Modal

Một thể hiện `Class.HapticEffect` sẽ phát khi `Class.GuiButton`
bị nhấn.

GuiButton.PressHapticEffect

Một thuộc tính boolean cho biết liệu đối tượng có được chọn hay không.

GuiButton.Selected

Đặt kiểu của `Class.GuiButton` dựa trên danh sách các kiểu đã được xác định trước.

GuiButton.Style

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

`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 đồ 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 thông qua [appearance modifiers](/ui/appearance-modifiers).

Mặc dù có thể phát hiện sự kiện nhấ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 riêng biệt thuận tiện như `Class.TextButton.Activated|Activated` để phát hiện nhấp/dí.

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 sẽ xảy ra khi một người chơi bắt đầu kéo đối tượng.

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

GuiObject.DragBegin

initialPosition

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.

Bị 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 mà người chơi dừng kéo GUI. Ví dụ, nếu người chơi
dừng kéo đối tượng ở (189, 180) thì câu lệnh dưới đây sẽ in: Người chơi đã
dừng kéo GuiObject ở (189, 180)

Sự kiện này sẽ xảy ra khi người chơi ngừ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.

Bị kích hoạt khi người chơi ngừng kéo đối tượng.

Ví dụ dưới đâ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 đứa con của _gui_.

Sự kiện này sẽ xảy ra khi một người dùng bắt đầu tương tác với `Class.GuiObject` thông qua một thiết bị giao diện người-máy (phím chuột nhấn, bắt đầu chạm, nút bàn phím nhấn, v.v).

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

Sự kiện này sẽ luôn xảy ra bất kể trạng thái của 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 của đầu vào`, và
`Class.InputObject.Position|tọa độ màn hình của đầu vào`.

Bị kích hoạt khi một người dùng bắt đầu tương tác thông qua một thiết bị giao diện người-máy (phím chuột nhấn, bắt đầu chạm, nút bàn phím nhấn, v.v).

Ví dụ sau đây minh họa một trong nhiều cách 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à con của _gui_.

Sự kiện này sẽ xảy ra khi người dùng thay đổi cách thức họ tương tác thông qua một thiết bị giao diện người-máy (phím chuột nhấn, bắt đầu chạm, nút bàn phím nhấn, v.v).

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

Sự kiện này sẽ luôn xảy ra bất kể trạng thái của trò chơi.

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

GuiObject.InputChanged

Bị kích hoạt khi người dùng thay đổi cách thức tương tác của họ thông qua một thiết bị giao diện người-máy (phím chuột nhấn, bắt đầu chạm, nút bàn phím nhấn, 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 phần tử con của _gui_.


Sự kiện InputEnded bị kích hoạt khi một người dùng ngừng tương tác thông qua một thiết bị giao diện người-máy (phím chuột nhấn, bắt đầu chạm, nút bàn phím nhấn, v.v).

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

Sự kiện này sẽ luôn xảy ra bất kể trạng thái của 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`.

Bị kích hoạt khi người dùng ngừng tương tác thông qua một thiết bị giao diện người-máy (phím chuột nhấn, bắt đầu chạm, nút bàn phím nhấn, v.v).

Ví dụ sau sẽ 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 bị kích hoạt khi 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 đối số `x` và `y` được truyền bởi sự kiện này như một cách an toà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 tọa độ chỉ ra vị trí của chuột khi sự kiện này xảy ra chứ không phải là thời điểm chính xác mà chuột vào GUI.

Sự kiện này xảy ra ngay cả khi phần tử GUI 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 người dùng di chuyển chuột vào một phần tử GUI.

Sự kiện MouseLeave bị kích hoạt khi 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 đối số `x` và `y` được truyền bởi sự kiện này như một cách an toà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 tọa độ chỉ ra vị trí của chuột khi sự kiện này xảy ra chứ không phải là thời điểm chính xác mà chuột rời khỏi GUI.

Sự kiện này xảy ra ngay cả khi phần tử GUI 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

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

Bị kích hoạt mỗi khi người dùng di chuyển chuột trong khi đang ở bên trong một phần tử `Class.GuiObject`. Nó tương tự như `Class.Mouse.Move`, xảy ra 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 xảy ra khi vị trí của chuột được cập nhật, do đó nó sẽ xảy ra nhiều lần trong khi đang di chuyển.

Các đối 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 đ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 xảy ra 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 đối số `x` và `y` có thể không hoàn toàn khớp với các tọa độ của các cạnh GUI.

##### Xem thêm

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

GuiObject.MouseMoved

Bị kích hoạt mỗi khi người dùng di chuyển chuột trong khi đang ở bên trong một phần tử GUI.

Sự kiện WheelBackward bị kích hoạt khi người dùng cuộn bánh xe chuột ra sau khi chuột ở trên một phần tử `Class.GuiObject`. Nó tương tự như `Class.Mouse.WheelBackward`, bị 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.

Sự kiện này xảy ra chỉ như một chỉ báo về sự di chuyển lùi của bánh xe. Điều này có nghĩa rằng 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

Bị kích hoạt khi người dùng cuộn bánh xe chuột ra sau khi chuột ở trên một phần tử GUI.

Sự kiện WheelForward bị kích hoạt khi người dùng cuộn bánh xe chuột về phía trước khi chuột ở trên một phần tử `Class.GuiObject`. Nó tương tự như `Class.Mouse.WheelForward`, bị 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.

Sự kiện này xảy ra chỉ như một chỉ báo về sự di chuyển tới của bánh xe. Điều này có nghĩa rằng các 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.

Bị kích hoạt khi người dùng cuộn bánh xe chuột về phía trước khi chuột ở 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
gamepad.

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

Sự kiện này bị kích hoạt khi trình chọn Gamepad bắt đầu tập trung vào `Class.GuiObject`.

Nếu bạn muốn kiểm tra khi trình chọn Gamepad ngừ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 tiêu điểm chọn lựa, giá trị của thuộc tính `Class.GuiService.SelectedObject|SelectedObject` cũng thay đổi thành giá trị đó được chọn. Để xác định phần GUI nào đã nhận được tiêu điểm chọn lựa, hãy kiểm tra giá trị của thuộc tính này.

GuiObject.SelectionGained

Bị kích hoạt khi GuiObject đang được tập trung bởi trình 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 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 bị kích hoạt khi trình chọn Gamepad ngừng tập trung vào `Class.GuiObject`.

Nếu bạn muốn kiểm tra khi trình 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 tiêu điểm chọn lựa, giá trị của thuộc tính `Class.GuiService.SelectionObject|SelectionObject` sẽ thay đổi thành `nil` hoặc đến phần GUI đã nhận được tiêu điểm chọn lựa. Để xác định phần GUI nào đã nhận được tiêu điểm chọn lựa, 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

Bị kích hoạt khi trình chọn Gamepad ngừ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, chẳng hạn như một `Frame`, bằng cách giữ ngón tay trên phần tử UI trong một thời gian ngắn.
Sau đó, người chơi di chuyển ngón tay và thả ra. Trong quá trình thực hiện
cử chỉ, Frame được tô màu xanh với viền trắng.

Sự kiện này được kích hoạt sau một khoảnh khắc 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ị có hỗ trợ cảm ứng. 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ỉ. Thêm vào đó, 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 khi thực hiện
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, thời gian trễ dài hơn một chút so với một giây.

GuiObject.TouchLongPress

touchPositions

Một mảng các `Datatype.Vector2` mô tả các vị trí **tương đối** của các ngón tay liên quan đến hành động này.

state

Một `Enum.UserInputState` mô tả trạng thái của hành động:

- Begin xảy ra một lần vào đầu hành động (sau độ trễ ngắn)
- Change xảy ra nếu người chơi di chuyển ngón tay trong khi nhấn
- End xảy ra một lần vào cuối hành động khi họ thả ngón tay ra.

Bị 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.

Đoạn 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 đối tượng `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 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ị có 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 cùng 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ỉ. Thêm vào đó,
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 khi thực hiện cử chỉ, và cuối cùng là 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 liên quan đến hành động.

totalTranslation

Cho biết khoảng cách mà cử chỉ pan đã di chuyển từ điểm bắt đầu của nó.

velocity

Cho biết tốc độ mà cử chỉ đang được thực hiện ở mỗi
dimension.

Cho biết `Enum.UserInputState` của cử chỉ.

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

Đoạn mã này dành cho một `LocalScript` bên trong một `Frame` bên trong một `Frame` khác, hoặc các `GuiObject` khác. Nó cho phép người chơi phóng to khung bên trong bằng cách thực hiện cử chỉ `Class.GuiObject.TouchPinch` trên khung 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 một cử chỉ
pinch hoặc pull trên phần tử UI bằng thiết bị có hỗ trợ cảm ứng. Một **pinch**
hồ xảy ra khi hai hoặc nhiều ngón tay di chuyển lại gần nhau, và một **pull**
hồ xảy ra 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
thao tác quy mô (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í màn hình tương đối của các ngón tay tham gia vào cử chỉ. Thêm vào đó,
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 khi thực hiện cử chỉ, và cuối cùng là với `Enum.UserInputState.End`. Cần
lưu ý rằng quy mô nên được sử dụng **theo phương pháp nhân**.

GuiObject.TouchPinch

Một mảng Luau của các đối tượng `Datatype.Vector2`, mỗi đối tượng cho biết 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 cho biết sự khác biệt từ lúc bắt đầu cử chỉ pinch.

Một số thực cho biết 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 kéo 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` bên trong một `Frame` bên ngoài, hoặc một `GuiObject` khác. Nó cho phép người chơi xoay khung bên trong bằng cách thực hiện một cử chỉ `Class.GuiObject.TouchRotate` trên khung 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 một cử chỉ
pinch hoặc pull trên phần tử UI bằng thiết bị có hỗ trợ cảm ứng. Sự xoay xảy ra
khi góc của đường nối 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 phép người chơi
thao tác độ 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ỉ. Thêm vào đó,
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 khi thực hiện cử chỉ, và cuối cùng là 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 cho biết vị trí của tất cả các ngón tay tham gia vào cử chỉ.

rotation

Một số thực cho biết mức độ xoay đã diễn ra từ khi bắt đầu cử chỉ.

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

Kích hoạt khi người chơi thực hiện một 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 mô phỏng của Studio).
Các cử chỉ vuốt ngang sẽ thay đổi sắc độ 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 một cử chỉ vuốt trên phần tử UI
bằng thiết bị có 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 các tab trong giao diện người dùng di động.

GuiObject.TouchSwipe

swipeDirection

Một `Enum.SwipeDirection` cho biết 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 vào cử chỉ (thường là 1).

Kích hoạt khi người chơi thực hiện một 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 một cử chỉ chạm trên phần tử UI
bằng thiết bị có hỗ trợ cảm ứng. Một lần chạm là một lần chạm nhanh đơn lẻ mà không có
sự di chuyển nào liên quan (một lần giữ lâu hơn sẽ kích hoạt
`Class.GuiObject.TouchLongPress`, và việc di chuyển trong lúc 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 `Datatype.Vector2` các đối tượng 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 một 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
phát hiện khi nào việc tween hoàn tất/hủy bỏ bằng cách định nghĩa một hàm callback. Nó
cũng in ra xem việc tween có điều chỉnh hay không.


Di chuyển mượt mà một GUI đến một vị trí `Datatype.UDim2` mới trong khoảng thời gian chỉ định bằng cách sử dụng `Enum.EasingDirection` và `Enum.EasingStyle` đã chỉ định.

Hàm này sẽ quay về xem tween có phát hay không. Nó sẽ không phát nếu một tween khác đang tác động đế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 nên được dễ dàng đi đến _endPosition_.

easingStyle

Phong cách mà GUI nên được dễ dàng đi đế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 diễn ra hay không.

callback

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

Di chuyển mượt mà một GUI đế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()`
Đoạn mã này khởi đầu một hoạt ảnh trên thuộc tính `Class.GuiObject.Size`
của cha với giá trị `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 (nó có bị hủy bỏ bởi hoạt ảnh khác hay đã hoàn thành).

Di chuyển mượt mà một `Class.GuiObject` đến một `Datatype.UDim2` mới trong khoảng thời gian chỉ định bằng cách sử dụng các `Enum.EasingDirection` và `Enum.EasingStyle`.

Hàm này sẽ quay về xem tween có phát hay không. Thông thường, điều này sẽ luôn quay về `true`, nhưng nó sẽ quay về `false` nếu một tween khác đang hoạt động và ghi đè được thiết lập thành `false`.

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

GuiObject:TweenSize

endSize

Kích thước mà GUI nên thay đổi kích thước.

Hướng mà GUI nên được dễ dàng đi đến _endSize_.

Phong cách mà GUI nên được dễ dàng đi đến _endSize_.

Tăng cường kích thước của một `Class.GuiObject` đến một `Datatype.UDim2` mới.

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

Tăng cường kích thước và di chuyển một GUI đến một kích thước và vị trí `Datatype.UDim2` mới trong khoảng thời gian chỉ định bằng cách sử dụng các `Enum.EasingDirection` và `Enum.EasingStyle`.

Hàm này sẽ quay về xem tween có phát hay không. Thông thường, điều này sẽ luôn quay về `true`, nhưng nó sẽ quay về `false` nếu một tween khác đang hoạt động và ghi đè được thiết lập thành `false`.

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

GuiObject:TweenSizeAndPosition

Hướng mà GUI nên được dễ dàng đi đến _endSize_ và _endPosition_.

Phong cách mà GUI nên được dễ dàng đi đến _endSize_ và _endPosition_.

Di chuyển mượt mà một GUI đế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, 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 `Class.GuiObject.Size` được mở rộng.

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

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

Kịch bản sau tạo một khung cha có kích thước tự động với
a`UIListLayout`, sau đó nó chèn một vài đối tượng `TextLabel`
 có kích thước tự động. 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.
Kịch bản này có thể được gán cho một `ScreenGui`.

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

Khi `Class.GuiObject.AutomaticSize|AutomaticSize` được thiết lập thành một giá trị `Enum.AutomaticSize` khác ngoà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 hoạt động của nó, 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 lại 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ư một `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 thiết lập 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` lần lượt.

Nếu thuộc tính này được thiết lập 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 của viền `Class.GuiObject`.

GuiObject.BorderColor

Mẫu mã này khiến cho đường viền của một GuiObject cha được đánh dấu 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 khác với `Class.GuiObject.BackgroundColor3`. Bạn sẽ không thấy viền của đối tượng nếu thuộc tính `Class.GuiObject.BorderSizePixel` được thiết lập thành `0`.

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

GuiObject.BorderColor3

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.