`Class.VideoDisplay` 是一個 GUI 物件，顯示來自透過 `Class.Wire` 連接的 `Class.VideoPlayer` 的影片內容。它的功能類似於 `Class.ImageLabel`，但專為影片播放而設計。


當 `Class.Wire` 連接或斷開連接後觸發，並且該 `Class.Wire` 現在或之前連接過 `Class.VideoDisplay` 上的一個引腳及某個其他可連接的實例。


VideoDisplay.WiringChanged

connected

指向 `Class.VideoDisplay` 的 `Class.Wire` 目標的引腳。


wire

連接 `Class.VideoDisplay` 和其他實例的 `Class.Wire`。


instance

現在或之前通過 `Class.Wire` 連接的其他實例。


當另一個實例通過 `Class.Wire` 連接到或從 `Class.VideoDisplay` 斷開連接時觸發。


返回與指定引腳連接的 `Class.Wire|Wires` 陣列。`Class.VideoDisplay` 有一個「輸入」引腳。


VideoDisplay:GetConnectedWires

返回與指定引腳連接的 `Class.Wire|Wires` 陣列。


獲取 `Class.Wire` 在 `Class.Wire.TargetName` 中可以使用的引腳列表，以便通過其 `Class.Wire.TargetInstance` 屬性連接到此實例。

對於 `Class.VideoDisplay`，這僅為 `Input`。


VideoDisplay:GetInputPins

一個表示有效引腳名稱的字串陣列。


獲取 `Class.Wire` 在 `Class.Wire.TargetName` 中可以使用的引腳列表，以便通過其 `Class.Wire.TargetInstance` 屬性連接到此實例。


獲取 `Class.Wire` 在 `Class.Wire.SourceName` 中可以使用的引腳列表，以便通過其 `Class.Wire.SourceInstance` 屬性連接到此實例。

對於 `Class.VideoDisplay`，這裡沒有。


VideoDisplay:GetOutputPins

獲取 `Class.Wire` 在 `Class.Wire.SourceName` 中可以使用的引腳列表，以便通過其 `Class.Wire.SourceInstance` 屬性連接到此實例。


VideoDisplay

決定影片在縮放時的外觀。預設情況下，影片在顯示在大於或小於其材質記憶體大小的螢幕上時會平滑化紋理。當設置為 `Enum.ResamplerMode.Pixelated|Enum.ResamplerMode.Pixelated` 時，影片將保留像素的銳利邊緣。


VideoDisplay.ResampleMode

選擇 `Class.VideoDisplay` 的材質重採樣模式。


決定當 UI 元素的寬高比與來源影片的寬高比不同時，影片材質如何渲染。

預設情況下，此屬性為 `Enum.ScaleType.Stretch`，它會簡單地拉伸/壓縮影片材質的尺寸，以精確適配 UI 元素的空間。


VideoDisplay.ScaleType

決定當影片顯示在其寬高比與來源影片不同的 UI 元素中時，影片將如何縮放。


VideoDisplay.TileSize

決定影片的著色方式。設置為白色時，不會發生著色。此屬性對於重用影片資源非常有用。


VideoDisplay.VideoColor3

允許與 `Class.VideoDisplay.VideoRectSize|VideoRectSize` 一起部分顯示影片。此屬性決定要顯示的影片區域的像素偏移量（從左上角算起）。


VideoDisplay.VideoRectOffset

要顯示的影片子區域的像素偏移量。


允許與 `Class.VideoDisplay.VideoRectOffset|VideoRectOffset` 一起部分顯示影片。此屬性決定要顯示的影片區域的像素大小。如果任一維度設置為 `0`，則將顯示整個影片。


VideoDisplay.VideoRectSize

決定要顯示的影片子區域的像素大小。


決定 UI 元素渲染的影片材質的 alpha 值。值為 `0` 時完全不透明，值為 `1` 時完全透明（不可見）。


VideoDisplay.VideoTransparency

一個顯示來自連接的 `Class.VideoPlayer` 的影片內容的 GUI 物件。


`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`（及其子代）是否可以在螢幕上拖動。

當玩家的手指在 `Class.GuiObject` 上被輕觸並保持時，`Class.GuiObject.GuiState|GuiState` 會被設置為 `Enum.GuiState.Press|Press`。同樣，當玩家的手指從 `Class.GuiObject` 上釋放時，`Class.GuiObject.GuiState|GuiState` 會被設置為 `Enum.GuiState.Idle|Idle`，而當 `Class.GuiObject.Interactable|Interactable` 在 `Class.GuiObject` 上關閉時，`Class.GuiState` 將設置為 `Enum.GuiState.NonInteractable|NonInteractable`。

GuiObject.GuiState

決定玩家的滑鼠是否正在 `Class.GuiObject` 上被按下。

GuiObject.InputSink

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

/reference/engine/classes/VideoDisplay.yaml