`Class.GuiButton` 是一個繼承自 `Class.GuiObject` 的抽象類別。
它是互動式、可點擊的 `Class.ImageButton` 和
`Class.TextButton` 物件的基礎類別。這個類別還定義了幾個互動行為的屬性，
即 `Class.GuiButton.AutoButtonColor|AutoButtonColor` 和
`Class.GuiButton.Modal|Modal`。

`Class.GuiButton` 最重要的事件是
`Class.GuiButton.Activated|Activated`，這是一個 **多平台事件**，
當按鈕被激活時會觸發。當使用滑鼠時，這意味著點擊按鈕並在游標仍然在 UI 物件上釋放。
對於觸控，適用相同的情況，但使用的是觸控而不是按鈕按下。最後，對於遊戲控制器，
當按下並釋放 **A** 按鈕時，若選中 `Class.GuiButton`，則會觸發
`Class.GuiButton.Activated|Activated`。簡而言之，這個事件對於多平台的使用者介面程式設計非常有用，
因為它為單一使用者輸入提供了一個良好的通用介面。

當在桌面上檢測到左鍵點擊按下並釋放時觸發，當在移動設備上檢測到觸控釋放時觸發，或在控制台的UI導航模式下激活**A**/交叉時觸發。

由於此事件不會在伺服器上觸發，因此應僅在`Class.LocalScript`中使用，或在`Class.Script`中使用，且`Class.Script.RunContext|RunContext`必須為`Enum.RunContext.Client`。

GuiButton.Activated

inputObject

clickCount

當使用者的滑鼠完全左鍵點擊 `Class.GuiButton` 時，此事件會觸發。

關於點擊，滑鼠必須在 `Class.GuiButton` 的範圍內，
而滑鼠按鈕必須先按下再釋放才能觸發此事件。如果滑鼠離開
`Class.GuiButton` 的範圍並被釋放，則此事件不會觸發。如果您希望避免此限制，
可以使用 `Class.GuiButton.MouseButton1Down|MouseButton1Down` 和
`Class.GuiButton.MouseButton1Up|MouseButton1Up`；這些事件是類似的，
但會在使用者按下或釋放左鍵時觸發。

GuiButton.MouseButton1Click

當使用者的滑鼠完全左鍵點擊 `Class.GuiButton` 時觸發。

當使用者按下滑鼠左鍵在 `Class.GuiButton` 上時，此事件會觸發。

如果事件要求使用者在 `Class.GuiButton` 上按下 **並** 釋放左鍵，
以便事件能夠觸發，請考慮使用 `Class.GuiButton.MouseButton1Click|MouseButton1Click`。

GuiButton.MouseButton1Down

滑鼠的 **X** 螢幕座標（以像素為單位）。

滑鼠的 **Y** 螢幕座標（以像素為單位）。

當使用者按下滑鼠左鍵在 `Class.GuiButton` 上時觸發。

當使用者釋放滑鼠左鍵在 `Class.GuiButton` 上時，此事件會觸發。

如果事件要求使用者在 `Class.GuiButton` 上按下 **並** 釋放左鍵，
以便事件能夠觸發，請考慮使用 `Class.GuiButton.MouseButton1Click|MouseButton1Click`。

GuiButton.MouseButton1Up

當使用者釋放滑鼠左鍵在 `Class.GuiButton` 上時觸發。

當使用者的滑鼠完全右鍵點擊 `Class.GuiButton` 時，此事件會觸發。

關於點擊，滑鼠必須在 `Class.GuiButton` 的範圍內，
而滑鼠按鈕必須先按下再釋放才能觸發此事件。如果滑鼠離開
`Class.GuiButton` 的範圍並被釋放，則此事件不會觸發。如果您希望避免此限制，
可以使用 `Class.GuiButton.MouseButton2Down|MouseButton2Down` 和
`Class.GuiButton.MouseButton2Up|MouseButton2Up`；這些事件是類似的，
但會在使用者按下或釋放右鍵時觸發。

GuiButton.MouseButton2Click

當使用者的滑鼠完全右鍵點擊 `Class.GuiButton` 時觸發。

當使用者按下滑鼠右鍵在 `Class.GuiButton` 上時，此事件會觸發。

如果事件要求使用者在 `Class.GuiButton` 上按下 **並** 釋放右鍵，
以便事件能夠觸發，請考慮使用 `Class.GuiButton.MouseButton2Click|MouseButton2Click`。

GuiButton.MouseButton2Down

當使用者按下滑鼠右鍵在 `Class.GuiButton` 上時觸發。

當使用者釋放滑鼠右鍵在 `Class.GuiButton` 上時，此事件會觸發。

如果事件要求使用者在 `Class.GuiButton` 上按下 **並** 釋放右鍵，
以便事件能夠觸發，請考慮使用 `Class.GuiButton.MouseButton2Click|MouseButton2Click`。

GuiButton.MouseButton2Up

當使用者釋放滑鼠右鍵在 `Class.GuiButton` 上時觸發。

當從滑鼠檢測到右鍵按下釋放，從觸控輸入檢測到長按，檢測到遊戲控制器的 `R3`，或者在使用鍵盤的 UI 瀏覽模式中檢測到 <kbd>Alt</kbd><kbd>Enter</kbd> 時觸發。

GuiButton.SecondaryActivated

代表替代激活動作的輸入對象。

當按鈕的 "secondary" 輸入被激活時觸發。

GuiButton

此屬性判斷當使用者的 `Class.Mouse` 懸停或點擊按鈕時，
按鈕是否會自動變更顏色。如果為 `true`，按鈕將在滑鼠懸停或點擊時自動變色。
如果為 `false`，按鈕則不會改變。

如果您希望自訂滑鼠懸停或點擊按鈕時按鈕如何變更，
請考慮使用 `Class.ImageButton` 並更改元素的 `Class.ImageButton.HoverImage|HoverImage` 和
`Class.ImageButton.PressedImage|PressedImage`。

請注意，如果 `Class.ImageButton` 的 `Class.ImageButton.Image|Image` 屬性被設定為一個圖片，
則此屬性不會有任何效果。此外，當 `Class.ImageButton` 的
`Class.ImageButton.HoverImage|HoverImage` 不是 `nil` 時，
此屬性不會影響滑鼠懸停時的行為；當 `Class.ImageButton` 的
`Class.ImageButton.PressedImage|PressedImage` 不是 `nil` 時，
這個屬性也不會影響滑鼠點擊行為。

GuiButton.AutoButtonColor

判斷當滑鼠懸停或點擊按鈕時，按鈕是否會自動變更顏色。

當滑鼠懸停在 `Class.GuiButton` 上時，將播放的 `Class.HapticEffect` 實例。

GuiButton.HoverHapticEffect

如果在 GUI 元素可見時為 `true`，則滑鼠不會被鎖定，除非右鍵按下。

GuiButton.Modal

當按下 `Class.GuiButton` 時，將播放的 `Class.HapticEffect` 實例。

GuiButton.PressHapticEffect

一個布林屬性，指示對象是否被選中。

GuiButton.Selected

根據預定樣式列表設置 `Class.GuiButton` 的樣式。

GuiButton.Style

互動式 2D 使用者介面元素的抽象類別。

`Class.GuiObject` 是一個抽象類別（類似於 `Class.BasePart`）用於 2D
使用者介面物件。它定義了所有與圖形使用者介面（GUI）物件顯示相關的屬性，如
`Class.GuiObject.Size|Size` 和 `Class.GuiObject.Position|Position`。它還具有一些有用的只讀屬性，如
`Class.GuiObject.AbsolutePosition|AbsolutePosition`、
`Class.GuiObject.AbsoluteSize|AbsoluteSize` 和 
`Class.GuiObject.AbsoluteRotation|AbsoluteRotation`。

要以特殊方式操作 GUI 物件的佈局，您可以使用如 [list/flex](/ui/list-flex-layouts) 或
[grid](/ui/grid-table-layouts) 的佈局結構，並且可以透過
[外觀修飾符](/ui/appearance-modifiers) 對它們進行額外的樣式設置。

雖然可以使用 `Class.GuiObject.InputBegan|InputBegan` 和
`Class.GuiObject.InputEnded|InputEnded` 檢測任何 GUI 物件上的滑鼠按鈕事件，但只有 `Class.ImageButton` 和
`Class.TextButton` 具有方便的專屬事件，如
`Class.TextButton.Activated|Activated` 來檢測點擊/按壓。

下面的例子假設它在一個如 `TextButton` 的 GuiObject 中，並且 `Class.GuiObject.Draggable` 屬性被設置為 true。它將打印玩家開始拖動物件時的 UDim2。

當玩家開始拖動物件時觸發此事件。

另請參見 `Class.GuiObject.DragStopped`。

GuiObject.DragBegin

initialPosition

拖動操作開始前 `Class.GuiObject` 的位置的 `Datatype.UDim2` 值。

下面的例子假設它在一個 GuiObject 內，如 `TextButton`，

並且

`Class.GuiObject.Draggable` 屬性被設置為 true。它會打印

玩家停止拖曳 GUI 的 X 和 Y 值。例如，如果玩家在 189, 180 停止拖曳物體，則下面會打印 "玩家停止在 (189, 180) 拖曳 GuiObject"

當玩家停止拖動物件時觸發此事件。

另請參見 `Class.GuiObject.DragBegin`。

GuiObject.DragStopped

滑鼠在螢幕上的 **X** 坐標，以像素為單位，相對於螢幕左上角。

滑鼠在螢幕上的 **Y** 坐標，以像素為單位，相對於螢幕左上角。

以下示例演示了根據用戶輸入類型來處理 InputBegan 的眾多使用範例之一。

為了使其按預期工作，必須將其放置在 `LocalScript` 中並且是 _gui_ 的子項。

當用戶通過人機介面設備（滑鼠按鈕向下、觸控開始、鍵盤按鈕向下等）與 `Class.GuiObject` 開始互動時觸發此事件。

`Class.UserInputService` 也有一個類似命名的事件，但不限制於特定的 UI 元素：`Class.UserInputService.InputBegan`。

此事件將始終在遊戲狀態下觸發。

另請參見 `Class.GuiObject.InputEnded` 和 `Class.GuiObject.InputChanged`。

GuiObject.InputBegan

input

一個 `Class.InputObject`，包含用於查詢用戶輸入的有用數據，例如 `Enum.UserInputType|輸入類型`、`Enum.UserInputState|輸入狀態`，以及 `Class.InputObject.Position|輸入的螢幕座標`。

當用戶通過人機介面設備開始互動時觸發（滑鼠按鈕向下、觸控開始、鍵盤按鈕向下等）。

以下範例展示如何根據輸入類型處理來自 InputChanged 的用戶輸入的多種使用情況。

為了使此功能如預期運作，必須將其放置在 `LocalScript` 中

並作為 _gui_ 的子項。

當用戶改變他們通過人機介面設備（滑鼠按鈕向下、觸控開始、鍵盤按鈕向下等）的互動方式時觸發此事件。

`Class.UserInputService` 也有一個類似命名的事件，但不限制於特定的 UI 元素：`Class.UserInputService.InputChanged`。

此事件將始終在遊戲狀態下觸發。

另請參見 `Class.GuiObject.InputBegan` 和 `Class.GuiObject.InputEnded`。

GuiObject.InputChanged

當用戶改變他們通過人機介面設備的互動方式時觸發（滑鼠按鈕向下、觸控開始、鍵盤按鈕向下等）。

以下範例展示了許多處理用戶輸入的使用範例，根據其類型從 InputEnded 處理輸入。 

為了使其正常運作，必須將其放置在 `LocalScript` 中，並且是 _gui_ 的子項。

當用戶停止通過人機介面設備（滑鼠按鈕向下、觸控開始、鍵盤按鈕向下等）互動時觸發 InputEnded 事件。

`Class.UserInputService` 有一個類似命名的事件，但不限制於特定的 UI 元素：`Class.UserInputService.InputEnded`。

此事件將始終在遊戲狀態下觸發。

另請參見 `Class.GuiObject.InputBegan` 和 `Class.GuiObject.InputChanged`。

GuiObject.InputEnded

一個 `Class.InputObject`，包含用於查詢用戶輸入的有用數據，例如 `Enum.UserInputType`、`Enum.UserInputState`，以及 `Class.InputObject.Position`。

當用戶停止通過人機介面設備互動時觸發（滑鼠按鈕向下、觸控開始、鍵盤按鈕向下等）。

以下範例在滑鼠進入 GUI 元素時打印滑鼠位置（以像素為單位）。

當用戶的滑鼠移入 `Class.GuiObject` 元素時觸發 MouseEnter 事件。

請勿依賴此事件傳遞的 `x` 和 `y` 參數作為確定用戶的滑鼠在何處進入 GUI 的可靠方法。這些坐標可能即使在滑鼠通過相同邊緣進入 GUI 時也會有所變化，尤其是在滑鼠快速進入元素時。這是因為坐標顯示事件觸發時滑鼠的位置，而不是滑鼠進入 GUI 的確切時刻。

即使當 GUI 元素在另一個元素之下渲染時，此事件依然會觸發。

如果您想追蹤用戶的滑鼠何時離開 GUI 元素，您可以使用 `Class.GuiObject.MouseLeave` 事件。

##### 另請參見

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

GuiObject.MouseEnter

當用戶的滑鼠移入 GUI 元素時觸發。

當用戶的滑鼠移出 `Class.GuiObject` 元素時觸發 MouseLeave 事件。

請勿依賴此事件傳遞的 `x` 和 `y` 參數作為確定用戶的滑鼠在何處離開 GUI 的可靠方式。這些坐標可能即使在滑鼠通過相同邊緣離開 GUI 時也會有所變化，尤其是在滑鼠快速離開元素時。這是因為坐標顯示事件觸發時滑鼠的位置，而不是滑鼠離開 GUI 的確切時刻。

即使當 GUI 元素在另一個元素之下渲染時，此事件依舊會觸發。

##### 另請參見

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

GuiObject.MouseLeave

當用戶的滑鼠移出 GUI 元素時觸發。

當用戶的滑鼠在 `Class.GuiObject` 元素內部移動時觸發。這類似於 `Class.Mouse.Move`，它無論用戶的滑鼠是否於 GUI 元素上方均會觸發。

注意，只有在滑鼠的位置更新時，此事件才會被觸發，因此在移動時會重複觸發。

`x` 和 `y` 參數指示用戶滑鼠的更新螢幕坐標（以像素為單位）。這些坐標對於確定滑鼠在 GUI 的位置、螢幕上的位置及與上次位置的差距非常有用。

以下代碼演示如何確定用戶滑鼠相對於 GUI 元素的 `Datatype.Vector2` 偏移：

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

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

local mouse = Players.LocalPlayer:GetMouse()

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


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

CustomScrollingFrame.MouseMoved:Connect(getPosition)
```
請注意，此事件可能不是在用戶的滑鼠進入或退出 GUI 元素時準確觸發。因此，`x` 和 `y` 參數可能不會完全對應到 GUI 邊緣的坐標。

##### 另請參見

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

GuiObject.MouseMoved

當用戶的滑鼠在 GUI 元素內部移動時觸發。

當用戶在 `Class.GuiObject` 元素上方向後滾動滑鼠滾輪時觸發 WheelBackward 事件。這類似於 `Class.Mouse.WheelBackward`，它無論用戶的滑鼠是否位於 GUI 元素上方均會觸發。

此事件僅作為滾輪向後移動的指示。這意味著 `x` 和 `y` 滑鼠坐標參數不會因為此事件而改變。這些坐標僅在滑鼠移動時改變，可以通過 `Class.GuiObject.MouseMoved` 事件來追蹤。

##### 另請參見

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

GuiObject.MouseWheelBackward

當用戶在 GUI 元素上方向後滾動滑鼠滾輪時觸發。

當用戶在 `Class.GuiObject` 元素上方向前滾動滑鼠滾輪時觸發 WheelForward 事件。這類似於 `Class.Mouse.WheelForward`，它無論用戶的滑鼠是否位於 GUI 元素上方均會觸發。

此事件僅作為滾輪向前移動的指示。這意味著 **X** 和 **Y** 滑鼠坐標參數不會因為此事件而改變。這些坐標僅在滑鼠移動時改變，可以通過 `Class.GuiObject.MouseMoved` 事件來追蹤。

##### 另請參見

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

GuiObject.MouseWheelForward

當用戶在 GUI 元素上方向前滾動滑鼠滾輪時觸發。

以下範例在使用者選擇帶有 gamepad 的物件時打印一條消息。

為了讓這像預期的那樣運作，它必須放置在 `LocalScript` 中

並且是 _gui_ 的子項。

當 Gamepad 選擇器開始聚焦於 `Class.GuiObject` 時觸發此事件。

如果您要檢查 Gamepad 選擇何時停止聚焦於 GUI 元素，可以使用 `Class.GuiObject.SelectionLost` 事件。

當 GUI 獲得選擇焦點時，`Class.GuiService.SelectedObject|SelectedObject` 屬性的值也會改變為獲得選擇的物件。要確定哪個 GUI 獲得了選擇，請檢查該屬性的值。

GuiObject.SelectionGained

當 Gamepad 選擇器聚焦於 GuiObject 時觸發。

以下示例當元素失去焦點時會打印消息

在遊戲手柄上。

為了使這個按預期工作，必須放在 `LocalScript`

並且是 _gui_ 的子項。

當 Gamepad 選擇器停止聚焦於 `Class.GuiObject` 時觸發此事件。

如果您想檢查 Gamepad 選擇何時開始聚焦於 GUI 元素，可以使用 `Class.GuiObject.SelectionGained` 事件。

當 GUI 失去選擇焦點時，`Class.GuiService.SelectionObject|SelectionObject` 屬性的值會變成 `nil` 或是獲得選擇焦點的 GUI 元素。要確定哪個 GUI 獲得選擇，或是不再選擇任何 GUI，檢查該屬性的值。

GuiObject.SelectionLost

當 Gamepad 選擇器停止聚焦於 GuiObject 時觸發。

此程式碼範本允許玩家通過短暫按住 UI 元素，例如 `Frame`，來操作某些

UI 元素的螢幕位置。然後，玩家移動手指並放開。在手勢期間，

Frame 會變成藍色並有白色輪廓。

當玩家在使用觸控裝置時，輕觸 UI 元件並保持手指的瞬間，這個事件會被觸發。它會附帶一個描述手指相對於屏幕位置的 `Datatype.Vector2` 表格。除此之外，它會多次觸發：在短暫延遲後的 `Enum.UserInputState.Begin`、如果玩家在手勢過程中移動手指則觸發 `Enum.UserInputState.Change`，以及最終的 `Enum.UserInputState.End`。延遲因平台而異；在 Studio 中，延遲稍長於一秒。

GuiObject.TouchLongPress

touchPositions

一個 `Datatype.Vector2` 的數組，描述涉及手勢的手指的 **相對** 位置。

state

一個 `Enum.UserInputState`，描述手勢的狀態：

- Begin 在手勢開始時觸發一次（在短暫的延遲後）
- Change 在玩家按下時移動手指時觸發
- End 在玩家釋放手指時觸發，結束手勢。

當玩家開始、繼續和停止長按 UI 元素時觸發。

'這段代碼範例旨在放置在一個位於外部 `Frame` 內的內部 `Frame` 中，或其他 `GuiObject`。它允許玩家通過在外部框架上移動手指來操控內部框架的位置。'

當玩家在使用觸控裝置時，移動手指在 UI 元件上，這個事件會被觸發。它會在 `Class.GuiObject.TouchSwipe` 之前不久觸發，並且不會和 `Class.GuiObject.TouchTap` 一起觸發。這個事件對於讓玩家操作屏幕上 UI 元件的位置非常有用。

此事件會附帶一個描述手指相對於屏幕位置的 `Datatype.Vector2` 表格。此外，它會多次觸發：在短暫延遲後的 `Enum.UserInputState.Begin`、當玩家在手勢過程中移動手指時的 `Enum.UserInputState.Change`，以及最終的 `Enum.UserInputState.End`。

GuiObject.TouchPan

一個 Luau 數組，包含每個 `Datatype.Vector2` 物件，表示手勢中所有手指的位置。

totalTranslation

表示滑動手勢相對於起始點的距離。

velocity

表示手勢在每個維度的執行速度。

當玩家在 UI 元素上移動手指時觸發。

此程式碼範例適用於位於內部 `Frame` 的 `LocalScript`，該 `Frame` 在一個外部 `Frame` 或其他 `GuiObject` 內部。它允許玩家通過在外部框架上執行 `Class.GuiObject.TouchPinch` 手勢來縮放內部框架。

當玩家在使用觸控裝置時，使用兩根手指進行縮放或拉伸手勢，這個事件會被觸發。**縮放**發生在兩根或更多手指靠得更近時，而**拉伸**則發生在它們分開時。此事件與 `Class.GuiObject.TouchPan` 一起觸發。這個事件對於讓玩家操作屏幕上 UI 元件的縮放（大小）非常有用，並且最常用於縮放功能。

此事件會附帶一個描述手指相對於屏幕位置的 `Datatype.Vector2` 表格。此外，它會多次觸發：在短暫延遲後的 `Enum.UserInputState.Begin`、當玩家在手勢期間移動手指時的 `Enum.UserInputState.Change`，以及最終的 `Enum.UserInputState.End`。值得注意的是，縮放應以 **乘法** 的方式使用。

GuiObject.TouchPinch

scale

一個浮點數，表示從縮放手勢開始的差異。

一個浮點數，表示縮放手勢的發生速度。

當玩家使用兩根手指在 UI 元素上執行縮放或拉動手勢時觸發。

此代碼範例用於內部 `Frame` 的 `LocalScript`，該 `Frame` 內部是位於外部 `Frame` 或其他 `GuiObject` 中。它允許玩家通過在外部框架上執行 `Class.GuiObject.TouchRotate` 手勢來旋轉內部框架。

當玩家在使用觸控裝置時，使用兩根手指進行縮放或拉伸手勢，這個事件會被觸發。當兩指之間的角度改變時，會發生旋轉。此事件與 `Class.GuiObject.TouchPan` 一起觸發。這個事件對於讓玩家操作屏幕上 UI 元件的旋轉非常有用。

此事件會附帶一個描述手指相對於屏幕位置的 `Datatype.Vector2` 表格。此外，它會多次觸發：在短暫延遲後的 `Enum.UserInputState.Begin`、當玩家在手勢期間移動手指時的 `Enum.UserInputState.Change`，以及最終的 `Enum.UserInputState.End`。

GuiObject.TouchRotate

一個 Luau 陣列的 `Datatype.Vector2` 物件，每個物件指示參與手勢的所有手指的位置。

rotation

一個浮點數，指示旋轉已從手勢開始時的角度移動了多少。

一個浮點數，表示手勢執行的速度。

當玩家使用兩根手指在 UI 元件上執行旋轉手勢時觸發。

此程式碼範例將使 `Frame`（或其他 `GuiObject`）在觸控設備（或 Studio 的模擬器）上執行滑動手勢時彈跳。

橫向滑動將改變 `Class.GuiObject.BackgroundColor3` 的色相，而縱向滑動將改變飽和度。

當玩家在使用觸控裝置時，對 UI 元件執行滑動手勢，這個事件會被觸發。它會附帶手勢的方向（向上、向下、向左或向右）和涉及手勢的觸控點數量。滑動手勢通常用於在移動 UI 中切換標籤。

GuiObject.TouchSwipe

swipeDirection

一個 `Enum.SwipeDirection`，指示擦拭手勢的方向（上、下、左或右）。

numberOfTouches

參與手勢的觸控點數量（通常為 1）。

當玩家在 UI 元件上執行擦拭手勢時觸發。

此代碼範例將在觸摸啟用的設備上點擊 UI 元件（如 `Frame`）時切換 `Class.GuiObject.BackgroundTransparency`。

當玩家在使用觸控裝置時，對 UI 元件執行輕觸手勢，這個事件會被觸發。輕觸是一個快速的單點觸碰，沒有任何運動（如果長按則會觸發 `Class.GuiObject.TouchLongPress`，移動過程中則會觸發 `Class.GuiObject.TouchPan` 和/或 `Class.GuiObject.TouchSwipe`）。它會附帶一個描述手指相對位置的 `Datatype.Vector2` 物件表。

GuiObject.TouchTap

一個 `Datatype.Vector2` 陣列，描述參與手勢的手指的 **相對** 位置。

當玩家在 UI 元件上執行輕觸手勢時觸發。

此代碼範例演示了 TweenPosition 更複雜的使用方式，通過定義回調函數來檢測 tween 是否完成/取消。它還會打印出 tween 是否會播放。

在指定的時間內平滑地將 GUI 移動到新的 `Datatype.UDim2` 位置，使用指定的 `Enum.EasingDirection` 和 `Enum.EasingStyle`。

此函數將返回 tween 是否會播放。如果有另一個 tween 作用在 `Class.GuiObject` 上且 override 參數為 `false`，則不會播放。

另請參見 `Class.GuiObject:TweenSize()` 和 `Class.GuiObject:TweenSizeAndPosition()`。

GuiObject:TweenPosition

endPosition

easingDirection

平滑移動到 _endPosition_ 的方向。

easingStyle

平滑移動到 _endPosition_ 的樣式。

time

完成 tween 所需的時間（以秒為單位）。

override

當前 tween 是否會覆蓋正在進行的 tween。

callback

當 tween 完成時要執行的回調函數。

平滑地將 GUI 移動到新的 `Datatype.UDim2`。

此程式碼範例展示了 `Class.GuiObject:TweenSize()` 函數的使用。
它在父物件的 `Class.GuiObject.Size` 屬性上啟動一個動畫，將其調整為 `UDim2.new(0.5, 0, 0.5, 0)`，這是 `GuiObject` 在兩個軸上的一半大小。
此外，它展示了如何使用回呼參數來檢測 tween 何時停止（無論是被另一個 tween 取消還是完成）。

在指定的時間內平滑地將 `Class.GuiObject` 調整大小到新的 `Datatype.UDim2`，使用指定的 `Enum.EasingDirection` 和 `Enum.EasingStyle`。

此函數將返回 tween 是否會播放。通常這將始終返回 `true`，但如果另一個 tween 是活動的並且 override 設置為 `false`，它將返回 `false`。

另請參見 `Class.GuiObject:TweenSize()` 和 `Class.GuiObject:TweenSizeAndPosition()`。

GuiObject:TweenSize

endSize

平滑地將 `Class.GuiObject` 調整大小到新的 `Datatype.UDim2`。

以下示例會將 `Class.Frame` 動畫到父物件的左上角的大小，並將其縮小到 0。

在指定的時間內平滑地將 GUI 調整大小並移動到新的 `Datatype.UDim2` 大小和位置，使用指定的 `Enum.EasingDirection` 和 `Enum.EasingStyle`。

此函數將返回 tween 是否會播放。通常這將始終返回 `true`，但如果另一個 tween 是活動的並且 override 設置為 `false`，它將返回 `false`。

另請參見 `Class.GuiObject:TweenSize()` 和 `Class.GuiObject:TweenSizeAndPosition()`。

GuiObject:TweenSizeAndPosition

平滑移動到 _endSize_ 和 _endPosition_ 的方向。

平滑移動到 _endSize_ 和 _endPosition_ 的樣式。

平滑地將 GUI 移動到新的大小和位置。

GuiObject

這段代碼範例展示了如何使用 Active 屬性作為 Activated 事件的防抖。

此屬性決定 `Class.GuiObject` 是否會將輸入「沉沒」到 3D 空間，例如與 `Class.ClickDetector` 類別下的基礎模型
如 `Class.DragDetector`。

對於 `Class.GuiButton` 物件（`Class.ImageButton` 和
`Class.TextButton`），此屬性決定 `Class.GuiButton.Activated|Activated` 是否會觸發
（`Class.GuiButton.AutoButtonColor|AutoButtonColor` 對它們仍然有效）。無論此屬性的值為何，事件
`Class.GuiObject.InputBegan|InputBegan`、
`Class.GuiObject.InputChanged|InputChanged` 和
`Class.GuiObject.InputEnded|InputEnded` 均會正常運作。

GuiObject.Active

這段程式碼範例將 UI 元素移動到父元素的不同邊緣。

它從左上角開始，並在右下角結束。將其貼到

屏幕 GUI 中的 Frame 的 LocalScript 中。

此屬性決定 `Class.GuiObject` 的原點，相對於其絕對大小。原點決定元素的位置（透過 `Class.GuiObject.Position`）&nbsp;
和所渲染的 `Class.GuiObject.Size` 的擴張部分。

詳情請參見 [此處](/ui/position-and-size#anchorpoint)。

GuiObject.AnchorPoint

決定 `Class.GuiObject` 的原點，相對於其絕對大小。

以下腳本創建一個自動調整大小的父框架，並插入幾個自動調整大小的 `TextLabel` 對象。注意父 `UIListLayout` 如何自動調整大小以適應其子內容，並且標籤會自動調整大小以適應其文本內容。這個腳本可以附加到 `ScreenGui`。

此屬性用於根據其子代的大小自動調整父 UI 物件的大小。您可以使用此屬性在編輯或運行時動態添加文本和其他內容到
UI 物件中，大小將自動調整以適應該內容。

當 `Class.GuiObject.AutomaticSize|AutomaticSize` 設置為除了 `Enum.AutomaticSize|None` 以外的 `Enum.AutomaticSize` 值時，這個 UI 物件可能會根據其子內容重新調整大小。

有關如何使用此屬性及其工作原理的更多資訊，請參見 [這裡](/ui/size-modifiers#automatic-sizing)。

GuiObject.AutomaticSize

決定是否根據子內容進行調整大小。

決定 `Class.GuiObject` 背景的顏色。

GuiObject.BackgroundColor

此程式碼範例使父框架循環顯示所有虹彩顏色，使用 Color3.fromHSV。

此屬性決定 `Class.GuiObject` 背景的顏色（填充顏色）。如果您的元素包含文本，例如 `Class.TextBox`、
`Class.TextButton` 或 `Class.TextLabel`，確保背景的顏色與文字的顏色形成對比。

另外一個決定背景可視屬性的屬性是 `Class.GuiObject.BackgroundTransparency`；如果設置為 `1`，則不會渲染背景或邊框。

另請參見 `Class.GuiObject.BorderColor3|BorderColor3`。

GuiObject.BackgroundColor3

此屬性決定 `Class.GuiObject` 背景和邊框的透明度。然而，如果 GUI 是 `Class.TextBox`、
`Class.TextButton` 或 `Class.TextLabel`，則不會決定文本的透明度；文本透明度由 `Class.TextBox.TextTransparency`、
`Class.TextButton.TextTransparency` 和 `Class.TextLabel.TextTransparency` 分別決定。

如果此屬性設置為 `1`，則背景和邊框將不會渲染，GUI 背景將完全透明。

GuiObject.BackgroundTransparency

決定 `Class.GuiObject` 背景和邊框的透明度。

決定 `Class.GuiObject` 邊框的顏色。

GuiObject.BorderColor

這段代碼示例使父 GuiObject 的邊框在用戶將鼠標懸停在元素上時高亮顯示。

決定 `Class.GuiObject` 矩形邊框的顏色（也稱為描邊顏色）。這與物件的 `Class.GuiObject.BackgroundColor3` 是分開的。如果其 `Class.GuiObject.BorderSizePixel` 屬性設置為 `0`，則無法看到物件的邊框。

請注意，`Class.UIStroke` 組件允許更先進的邊框效果。

GuiObject.BorderColor3

此屬性決定 `Class.GuiObject` 邊框相對於其尺寸的佈局方式，使用同名列舉 `Enum.BorderMode`。

注意，`Class.UIStroke` 可以覆蓋此屬性，並允許更先進的邊框效果。

GuiObject.BorderMode

決定 `Class.GuiObject` 邊框相對於其尺寸的佈局方式。

此屬性決定 `Class.GuiObject` 邊框渲染的寬度（以像素為單位）。將其設置為 0 將完全禁用邊框。

注意，`Class.UIStroke` 可以覆蓋此屬性，並允許更先進的邊框效果。

GuiObject.BorderSizePixel

決定 `Class.GuiObject` 邊框的像素寬度。

此屬性決定 `Class.GuiObject` 是否會裁剪（隱藏）任何部分的子 GUI 元素，這些元素會在矩形的邊界外渲染。

請注意，此屬性不支持 `Class.GuiObject.Rotation|Rotation`。如果此物件或任何祖先 GUI 具有 **非零** `Class.GuiObject.Rotation|Rotation`，則此屬性將 **被忽略**，且子 GUI 元素將無論此屬性的值如何仍然被渲染。

GuiObject.ClipsDescendants

決定是否應渲染在父 GUI 元素邊界外的子 `Class.GuiObject|GuiObjects`。

此屬性表示 `Class.GuiObject`（及其子代）是否可以在螢幕上拖動。

GuiObject.Draggable

決定 `Class.GuiObject`（及其子代）是否可以在螢幕上拖動。

所有 2D 使用者介面的抽象類別物件。