`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 對象的布局，您可以使用 [列表/柔性](/ui/list-flex-layouts) 或 [網格](/ui/grid-table-layouts) 等布局結構，並通過 [外觀修改器](/ui/appearance-modifiers) 為它們超出核心屬性進行格式化。

  雖然使用 `Class.GuiObject.InputBegan|InputBegan` 和 `Class.GuiObject.InputEnded|InputEnded` 可以在任何 GUI 對象上偵測滑鼠按鈕事件，但只有 `Class.ImageButton` 和 `Class.TextButton` 有方便的專用事件，例如 `Class.TextButton.Activated|Activated` 來偵測點擊/按下。

The below example assumes it's within a GuiObject such as a `TextButton`, and
that the `Class.GuiObject.Draggable` property is set to true. It will print
the UDim2 of where the player started dragging the object from.

當玩家開始拖動物件時，此事件會發生。

  也見 `Class.GuiObject.DragStopped` 。

GuiObject.DragBegin

initialPosition

在任何拖動操作開始之前的 `Datatype.UDim2` 位置值，`Class.GuiObject` 前。

當玩家開始拖動對物件時發射。

下面的例子假設它在 GuiObject 中，例如 `TextButton` , 並且 `Class.GuiObject.Draggable` 屬性設為真值。它會打印玩家停止拖動 GUI 的 X 和 Y。例如，如果玩家在 189 時停止拖曳對象，下面將打印玩家停止拖曳 GuiObject 在 (189, 180)

當玩家停止拖動對物件時，此事件發生。

  也見 `Class.GuiObject.DragBegin` 。

GuiObject.DragStopped

滑鼠的 **X** 屏幕位置以畫素為單位，相對於屏幕左上角。

滑鼠的 **Y** 畫面位置以畫素為單位，相對於屏幕左上角。

當玩家停止拖動對物件時發射。

The following example demonstrates one of many usage examples of handling user
input from InputBegan depending on its type.

In order for this to work as expected, it must be placed in a `LocalScript`
and a child of _gui_.

當使用者開始與 `Class.GuiObject` 通過人工智慧輸入裝置互動時，此事件會發生（例如：滑鼠按鈕向下、觸摸開始、鍵盤按鈕向下等）。

  `Class.UserInputService` 有相同名稱的事件，不受限於特定的使用者介面元素：`Class.UserInputService.InputBegan` 。

  此事件將無論遊戲狀態如何總是發射。

  也見 `Class.GuiObject.InputEnded` 和 `Class.GuiObject.InputChanged` 。

GuiObject.InputBegan

input

一個 `Class.InputObject` , 包含用於查詢用戶輸入的有用數據，例如 `Enum.UserInputType|type of input` , `Enum.UserInputState|state of input` 和 `Class.InputObject.Position|screen coordinates of the input` 。

當使用者開始使用人工智慧與電腦介面裝置（例如滑鼠按鈕向下、觸摸開始、鍵盤按鈕向下等）時發射。

The following example demonstrates one of many usage examples of handling user
input from InputChanged depending on its type.

In order for this to work as expected, it must be placed in a `LocalScript`
and a child of _gui_.

當使用者變更如何透過人工智慧與電腦介面裝置（滑鼠按鈕向下、觸摸開始、鍵盤按鈕向下等）進行互動時，此事件會發生。

  `Class.UserInputService` 有相同名稱的事件，不受限於特定的使用者介面元素：`Class.UserInputService.InputChanged` 。

  此事件將無論遊戲狀態如何總是發射。

  也見 `Class.GuiObject.InputBegan` 和 `Class.GuiObject.InputEnded` 。

GuiObject.InputChanged

當使用者變更如何透過人工智慧與電腦介面裝置（滑鼠按鈕向下、觸摸開始、鍵盤按鈕向下等）進行互動時，發射時間。

The following example demonstrates one of many usage examples of handling user
input from InputEnded depending on its type.

In order for this to work as expected, it must be placed in a `LocalScript`
and a child of _gui_.

輸入已結束事件會在使用者停止使用人工智慧與電腦介面裝置（滑鼠按鈕向下、觸摸開始、鍵盤按鈕向下等）互動時發生。

  `Class.UserInputService` 有相同名稱的事件，不受限於特定的使用者介面元素：`Class.UserInputService.InputEnded` 。

  此事件將無論遊戲狀態如何總是發射。

  也見 `Class.GuiObject.InputBegan` 和 `Class.GuiObject.InputChanged` 。

GuiObject.InputEnded

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

當使用者停止使用人工智慧與電腦介面裝置（例如：滑鼠按鈕向下、觸摸開始、鍵盤按鈕向下等）互動時，發射。

The following example prints the mouse location, in pixels, when it enters GUI
element.

當使用者將滑鼠移入 `Class.GuiObject` 元素時，滑鼠進入事件發生。

  請勿依賴此事件傳回的 `x` 和 `y` 參數來確定使用者的鼠標在進入 GUI 時的位置。即使在滑鼠通過相同的邊緣進入 GUI 時，這些坐標可能會變化 - 特別是當滑鼠快速進入元素時。這是因為協調點指示的位置是事件發生時的滑鼠位置，而不是滑鼠進入 GUI 的準確時刻。

  此事件即使在 GUI 元素在另一個元素下渲染時也會發生。

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

  ##### 也見「也見」

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

GuiObject.MouseEnter

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

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

當使用者將鼠標移到 GUI 元素時發生火災。

當使用者將鼠標從 `Class.GuiObject` 元素移出時，滑鼠離開事件會發生。

  請勿依賴這個事件傳回的 `x` 和 `y` 參數作為確定使用者鼠標位置的絕對方式。即使在滑鼠通過相同的邊緣離開 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、畫面和delta上確定鼠滑鼠的位置，因為如果在全球變量中跟蹤鼠滑鼠，它的前一個位置。

  下面的代碼示範如何確定使用者的滑鼠相對於 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` 元素上時。與 `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` 元素上時。與 `Class.Mouse.WheelForward` 相似，無論使用者的滑鼠是否在 GUI 元素上，都會發射。

  這個事件只是輪子前進的指標。這意味著 **X** 和 **Y** 滑鼠坐標參數在此事件發生後不會發生變化。這些坐標只會在滑鼠移動時變更，可以透過 `Class.GuiObject.MouseMoved` 事件進行追蹤。

  ##### 也見「也見」

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

GuiObject.MouseWheelForward

當使用者將滑鼠輪向前滾動時，發生火災，當滑鼠在 GUI 元素上時。

The following example prints a message when the user selects the object with a
gamepad.

In order for this to work as expected, it must be placed in a `LocalScript`
and a child of _gui_.

此事件會在遊戲控制器選擇器開始專注於 `Class.GuiObject` 時發生。

  如果你想從遊戲手柄選擇停止關注 GUI 元素，你可以使用 `Class.GuiObject.SelectionLost` 事件。

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

GuiObject.SelectionGained

當使用遊戲控制器選擇器將 GuiObject 聚焦時，發射。

The following example prints a message when the element has its focus lost on
a gamepad.

In order for this to work as expected, it must be placed in a `LocalScript`
and a child of _gui_.

此事件會在遊戲控制器選擇器停止對 `Class.GuiObject` 的焦點時發生。

  如果你想從遊戲手柄選擇開始關注 GUI 元素，你可以使用 `Class.GuiObject.SelectionGained` 事件。

  當使用者介面失去選擇焦點時，`Class.GuiService.SelectionObject|SelectionObject` 屬性值會變更為`nil` 或獲得選擇焦點的 GUI 元素。要確定哪個 GUI 獲得選擇，或者如果沒有選擇任何 GUI，請檢查此屬性的值。

GuiObject.SelectionLost

當遊戲控制器選擇器停止關注 GuiObject 時發射。

This code sample allows the player to manipulate the screen position of some
UI element, like a `Frame`, by holding down on the UI element for a brief
moment. Then, the player moves their finger and releases. During the gesture
the Frame is colored blue with a white outline.

此事件在玩家使用觸摸啟用的裝置將手指放在介面元素上時發生短暫時間後發射。它使用描述手指相對屏幕位置的 `Datatype.Vector2` 表發射。此外，它會多次發射：`Enum.UserInputState.Begin`後短暫延遲，`Enum.UserInputState.Change`如果玩家在姿勢期間移動手指，最後`Enum.UserInputState.End`。延遲是平台依賴的；在 Studio 中，它比一秒多一點。

  由於此事件只需要一個手指，因此可以使用 Studio 的模擬器和滑鼠來模擬此事件。

GuiObject.TouchLongPress

touchPositions

一個由   組成的陣列，用於描述參與手勢的手指的相對位置。

state

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

  *   開始火焰一次在手勢開始時（在短暫延遲後）
  *   如果玩家在按下時移動手指，則更改火焰
  *   在他們釋放手指時，一次在動作結束時結束火焰。

當玩家開始、繼續並停止長按 UI 元素時，發生火災。

This code sample is meant to be placed in a `LocalScript` within an inner
`Frame` that is inside an outer `Frame`, or other `GuiObject`. It allows the
player to manipulate the position of the inner frame by moving their finger on
the outer frame.

當玩家使用具有觸摸啟用的裝置移動手指到 UI 元素時，此事件會發生。它在 `Class.GuiObject.TouchSwipe` 之前短時間發射，並不會與 `Class.GuiObject.TouchTap` 發射。這個事件有助於允許玩家在畫面上操縱 UI 元素的位置。

  這個事件發射時使用 `Datatype.Vector2` 桌子來描述參與手勢的手指相對畫面位置。此外，它會多次發射：`Enum.UserInputState.Begin`在短暫延遲後，`Enum.UserInputState.Change`當玩家移動手指時，以及最後使用 `Enum.UserInputState.End` 。

  這個事件無法在 Studio 使用模擬器和滑鼠模擬；你必須擁有一個真實啟用觸摸的裝置才能發射它。

GuiObject.TouchPan

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

totalTranslation

指示盤子動作已經從起始點走了多遠。

velocity

指示每個維度中手勢的執行速度。

當玩家在介面元素上移動手指時發生火災。

This code sample is meant for a `LocalScript` within an inner `Frame` that is
inside an outer `Frame`, or other `GuiObject`. It allows the player to scale
the inner frame by performing a `Class.GuiObject.TouchPinch` gesture on the
outer frame.

當玩家使用兩個手指對介面元素施加撓動或拉動動作時，此事件會發生，使用觸摸啟用的裝置。當兩個或更多手指靠近時，會發生 **扭曲** ；當它們分開時，會發生 **拉拔** 。此事件與 `Class.GuiObject.TouchPan` 同時發生。這個事件有助於允許玩家操縱屏幕上的 UI 元素的尺寸（尺寸），最常用於縮放功能。

  這個事件發射時使用 `Datatype.Vector2` 桌子來描述參與手勢的手指相對畫面位置。此外，它會多次發射：`Enum.UserInputState.Begin`在短暫延遲後，`Enum.UserInputState.Change`當玩家在姿勢期間移動手指時，最後使用 `Enum.UserInputState.End` 。應該注意的是，比例應該用作乘數 **。** 
  由於此事件需要至少兩個手指，因此無法使用模擬器和滑鼠在 Studio 中模擬；您必須擁有一個真實啟用觸摸的裝置。

GuiObject.TouchPinch

一個由 `Datatype.Vector2` 個物件組成的 Luau 陣列，每個指示所有涉及按壓手勢的手指位置。

scale

指示從捏造手勢開始的差異的漂浮點。

當玩家使用介面元素上的兩個手指執行撥動或拉動動作時，發生火焰。

This code sample is meant for a `LocalScript` within an inner `Frame` that is
inside an outer `Frame`, or other `GuiObject`. It allows the player to rotate
the inner frame by performing a `Class.GuiObject.TouchRotate` gesture on the
outer frame.

當玩家使用兩個手指對介面元素施加撓動或拉動動作時，此事件會發生，使用觸摸啟用的裝置。旋轉發生在兩個手指之間線的角度變更時。此事件與 `Class.GuiObject.TouchPan` 同時發生。這個事件有助於允許玩家在畫面上操縱 UI 元素的旋轉。

  這個事件發射時使用 `Datatype.Vector2` 桌子來描述參與手勢的手指相對畫面位置。此外，它會多次發射：`Enum.UserInputState.Begin`在短暫延遲後，`Enum.UserInputState.Change`當玩家在姿勢期間移動手指時，最後使用 `Enum.UserInputState.End` 。

  由於此事件需要至少兩個手指，因此無法使用模擬器和滑鼠在 Studio 中模擬；您必須擁有一個真實啟用觸摸的裝置。

GuiObject.TouchRotate

rotation

一個浮點，表示旋轉從手勢開始時已經進行了多少。

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

當玩家使用介面元素上的兩個手指執行旋轉動作時，發生火災。

這個代碼樣本會導致在觸摸啟用的裝置（或 Studio 的模擬器）上執行撥動動作時彈出 `Frame` （或其他 `GuiObject`）。水平滑動會改變 `Class.GuiObject.BackgroundColor3` 的顏色，垂直滑動會改變飽和度。

當玩家使用具有觸控功能的裝置在 UI 元素上執行滑動動作時，此事件會發生。它以手勢方向（向上、向下、向左或向右）和涉及手勢的觸點數量發射。滑動手勢通常用於在移動用戶介面中變更標籤。

  因為這個事件只需要一個手指，所以可以在 Studio 使用模擬器和滑鼠來模擬。

GuiObject.TouchSwipe

swipeDirection

A `Enum.SwipeDirection` 指示撥動手勢的方向（向上、向下、向左或向右）。

numberOfTouches

手勢中涉及的觸點數量（通常為 1）。

當玩家在介面元素上執行滑動動作時，發生火災。

This code sample will toggle the `Class.GuiObject.BackgroundTransparency` of a
UI element, like a `Frame`, when it is tapped on a touch-enabled device.

當使用已啟用觸碰的裝置時，玩家在介面元素上執行點擊動作時，此事件會發生。點擊是一種快速的單次觸碰，不需要任何運動參與（長按會發射 `Class.GuiObject.TouchLongPress` ，移動期間會發射 `Class.GuiObject.TouchPan` 和/或 `Class.GuiObject.TouchSwipe`）。它使用描述手指相對位置的 `Datatype.Vector2` 對象表發射。

  因為這個事件只需要一個手指，所以可以在 Studio 使用模擬器和滑鼠來模擬。

GuiObject.TouchTap

當玩家在介面元素上執行點擊動作時，發生火焰。

This code sample demonstrates a more involved usage of TweenPosition by
detecting when the tween completes/cancels by defining a callback function. It
also prints whether the tween will play.

使用指定的 `Datatype.UDim2` 和 `Enum.EasingDirection` 以及 `Enum.EasingStyle` 順利將 GUI 移到指定時間的新位置。

  此功能將返回漢子是否會播玩 遊玩。如果另一個青少年正在操作 `Class.GuiObject` 和覆蓋參數是 `false` ，將不會播放。

  也見 `Class.GuiObject:TweenSize()` 和 `Class.GuiObject:TweenSizeAndPosition()` 。

GuiObject:TweenPosition

endPosition

easingDirection

將 GUI 移至 *終端位置* 的方向。

easingStyle

將 GUI 移至 *結束位置* 的風格。

time

青少年需要多久才能完成，以秒為單位。

override

青少年是否會覆蓋進行中的青少年。

callback

在青少年完成時執行的回呼函數。

順暢將 GUI 移動到新的 `Datatype.UDim2` 。

This code sample demonstrates the usage of the `Class.GuiObject:TweenSize()`
function. It initiates an animation on the parent's `Class.GuiObject.Size`
property to `UDim2.new(0.5, 0, 0.5, 0)`, which is half the `GuiObject`'s
parent size on both axes.

Additionally, it demonstrates how the callback parameter can be used to detect
when the tween stops (whether it was cancelled by another tween or completed).

使用指定的 `Class.GuiObject` 和 `Enum.EasingStyle` 將一個 `Datatype.UDim2` 平滑地調整為新的 `Enum.EasingDirection` 在指定的時間。

  此功能將返回漢子是否會播玩 遊玩。通常這會永遠返回`true`，但如果另一個青少年啟用了並將覆蓋設為`false`，則會返回`false`。

  也見 `Class.GuiObject:TweenSize()` 和 `Class.GuiObject:TweenSizeAndPosition()` 。

GuiObject:TweenSize

endSize

將 GUI 調整到 *結束尺寸* 的風格。

順利將 `Class.GuiObject` 縮放到新的 `Datatype.UDim2` 。

The below example would tween a `Class.Frame` to the top left of the parent's
size and resize it down to 0.

使用指定的 `Datatype.UDim2` 和 `Enum.EasingDirection` 及 `Enum.EasingStyle` 將 GUI 平滑地縮放到指定時間的新尺寸和位置。

  此功能將返回漢子是否會播玩 遊玩。通常這會永遠返回`true`，但如果另一個青少年啟用了並將覆蓋設為`false`，則會返回`false`。

  也見 `Class.GuiObject:TweenSize()` 和 `Class.GuiObject:TweenSizeAndPosition()` 。

GuiObject:TweenSizeAndPosition

將 GUI 移至 *endSize* 和 *endPosition* 的方向。

將 GUI 調整到 *endSize* 和 *endPosition* 的風格。

順暢將 GUI 移動到新的尺寸和位置。

GuiObject

This code sample demonstrates the usage of the Active property as a debounce
for the Activated event.

此屬性決定是否會將 `Class.GuiObject` 輸入傾斜到 3D 空間，例如底層模型具有 `Class.ClickDetector` 類似的 `Class.DragDetector` 類。

  對於    物件 (    和     )，此屬性決定是否發生火災 (    對於這些物件也仍然有效)。事件 `Class.GuiObject.InputBegan|InputBegan` , `Class.GuiObject.InputChanged|InputChanged` 和 `Class.GuiObject.InputEnded|InputEnded` 無論值多少都正常運作。

GuiObject.Active

決定這個介面元素是否會沉沒輸入。

這個代碼示例將介面元素移動到父元素的不同側面。它從左上角開始到右下角結束。貼到框架中的本地腳本，在屏幕管理器中。

此屬性決定了 `Class.GuiObject` 的起始點，相對於其絕對尺寸。起始點決定從哪裡元素被放置(通過 `Class.GuiObject.Position` )和從哪裡渲染的 `Class.GuiObject.Size` 擴展。

  請見 [這裡](/ui/position-and-size#anchorpoint) 獲得說明圖和詳情。

GuiObject.AnchorPoint

決定 `Class.GuiObject` 的起始點，相對於其絕對尺寸。

以下腳本創建了自動調整大小的父框 `UIListLayout` ，然後插入了幾個自動調整大小的 `TextLabel` 對象。注意父 `UIListLayout` 自動調整以適應其子內容和標籤自動調整以適應其文字內容。此腳本可以轉為 `ScreenGui` 的父腳本。

此屬性用於自動根據子孫的大小來調整父級 UI 對象的大小。您可以使用此屬性來在編輯或運行時動態添加文字和其他內容到 UI 對象，並且尺寸會調整以適應該內容。

  當    設為    值以外的任何東西時，此 UI 對象可能會根據其子內容進行縮放。

  有關如何使用此屬性以及它如何運作的更多信息，請參閱 [這裡](/ui/size-modifiers#automatic-sizing)。

GuiObject.AutomaticSize

決定是否基於兒童內容進行縮放。

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

GuiObject.BackgroundColor

This code sample causes a parent Frame to loop through all colors of the
rainbow using 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`，背景和邊框將不會渲染，使用者介面背景將完全透明。

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 有  非零  ，這個屬性將被忽略，子孫 GUI 元素將無論如何渲染，無視此屬性的值。

GuiObject.ClipsDescendants

決定是否在父 GUI 元素的範圍之外成像子元素 `Class.GuiObject|GuiObjects` 。

這表示是否可以將 `Class.GuiObject` (以及其子孫) 拖到屏幕上。

GuiObject.Draggable

決定是否可以將 `Class.GuiObject` (以及其子孫) 拖到屏幕上。

當玩家的手指被點擊並保持在 `Class.GuiObject` 上時, `Class.GuiObject.GuiState|GuiState` 的 `Class.GuiObject` 將被設置為 `Enum.GuiState.Press|Press`。相同地，當玩家的手指從 `Class.GuiObject` 被釋放時，`Class.GuiObject.GuiState|GuiState` 的 `Class.GuiObject` 將被設置為 `Enum.GuiState.Idle|Idle`，當 `Class.GuiObject.Interactable|Interactable` 被關閉在 `Class.GuiObject` 時，`Class.GuiState` 的 `Class.GuiObject` 將被設置為 `Enum.GuiState.NonInteractable|NonInteractable`。

GuiObject.GuiState

決定玩家的鼠標是否在 `Class.GuiObject` 上被主動按下。

決定是否可以與 `Class.GuiButton` 互動，或者 `Enum.GuiState|GuiState` 的 `Class.GuiObject` 是否正在變更。

  在 `Class.GuiButton` 上：

  *   當 `Class.GuiObject.Interactable|Interactable` 設定在 `Class.GuiButton` 上設置為 `false` 時，`Class.GuiButton` 將無法再按下或點擊，而 `Class.GuiObject.GuiState|GuiState` 將被設置為 `Enum.GuiState.NonInteractable|NonInteractable` 。
  *   當 `Class.GuiObject.Interactable|Interactable` 設定在 `Class.GuiButton` 上設為 `true` 時，`Class.GuiButton` 將正常運作，而 `Class.GuiObject.GuiState|GuiState` 將正常運作。

  在 `Class.GuiObject` 上：

  *   當 `Class.GuiObject.Interactable|Interactable` 設定在 `Class.GuiButton` 上設為 `false` 時，`Class.GuiObject.GuiState|GuiState` 將會一直設為 `Enum.GuiState.NonInteractable|NonInteractable`。
  *   當 `Class.GuiObject.Interactable|Interactable` 設定在 `Class.GuiButton` 上設置為 `true` 時，`Class.GuiObject.GuiState|GuiState` 將再次正常運作。

GuiObject.Interactable

決定是否可以與 `Class.GuiButton` 互動，或者 `Enum.GuiState|GuiState` 的 `Class.GuiObject` 是否正在變更。

此屬性控制使用    （例如    或    ）時的排序順序，當    設為    時。如果對象沒有兄弟 UI 布局結構，就沒有功能。

  `Class.GuiObject|GuiObjects` 在上升的順序中排序，低值優先於高值。具有相同值的對象會回到它們被添加的順序。

  如果您不確定未來是否需要在兩個現有元素之間添加元素，那麼使用 `100` ( `0` , `100` , `200` ,等) 的倍數是一個很好的習慣。這樣可以確保間隔大的布局順序值，可用於在其他元素之間訂購的元素。

  也參見 `Class.GuiObject.ZIndex|ZIndex` ，這會決定對物件的 **渲染順序** 而不是排序順序。

GuiObject.LayoutOrder

控制使用 `Class.GuiObject` 與 `Class.UIGridStyleLayout` 時的排序順序。

這個例子顯示如何通過網格的 `GuiObject|GUI` 元素啟用遊戲板導航，而不需要手動連接 `Class.GuiObject.NextSelectionUp` , `Class.GuiObject.NextSelectionDown` 和 `GuiObject|NextSelectionRight` , 以及 `Class.GuiObject.NextSelectionLeft` 每個網格元素的  屬性。

  請注意，這個代碼樣本假設你的 `UIGridLayout` 排序為 `Class.UIGridLayout.SortOrder|name` ,元素的名稱是依次排列的數字順序。

  代碼依據此來設置下一個選擇屬性對所有 `GuiObjects` 在同一等級上的 UIGridLayout。在我們的例子中，網格內的 UIGridLayoutObject 和 GUI 元素都是 `Frame` 名為 *"容器"* 的子孫。代碼 `Class.Instance:GetChildren()|gets the children` 的 *"容器"* 和循環通過每個孩子。不是 GuiObject 的兒童被忽略。對於每個 GUI 元素，代碼嘗試使用以下邏輯來分配下一個選擇屬性：

  1.  從 1 開始,所有 GUI 元素的名稱與網格上的位置相匹配
  2.  左：左邊的項目總是會比當前元素少數 1 個號碼
  3.  右：左邊的項目總是比當前元素多數字 1 個
  4.  向上：上面的項目（向上）將永遠少於當前元素 1 個 GUI 數量
  5.  向下：下方的項目（向下）將永遠是行中的 GUI 數量多於當前元素 此邏輯也允許行首和尾的 GUI 元素（不包括第一和最後元素）繞到下一行和上一行包裝。如果元素向左、向右、向上或向下不存在，下一個選擇將保持為零，將游戏手柄選擇器移動到相反的方向不會更改選擇的 GUI。

  這個例子也包含使用鍵盤上的箭頭鍵（向上、向下、向左、向右）測試網格的代碼，以防你沒有鍵盤可以測試。這段代碼最初會選擇命名為 *"1"* 的元素，將其指派給 `Class.GuiService.SelectedObject` 屬性。

此屬性設置在使用者向下移動遊戲控制器選擇器時所選擇的   屬性。如果此屬性為空，將遊戲手柄向下移動不會更改選擇的 GUI。

  將遊戲控制器選擇器向下移動設置 `Class.GuiService.SelectedObject` 到此對象，除非 GUI 不是 `Class.GuiObject.Selectable|Selectable` 。請注意，此屬性可以設為 GUI 元素，即使它不是 `Class.GuiObject.Selectable|Selectable` ，因此您應該確保 GUI 的可選擇屬性值與預期的行為匹配。

  也見 `Class.GuiObject.NextSelectionUp|NextSelectionUp` , `Class.GuiObject.NextSelectionLeft|NextSelectionLeft` , 及 `Class.GuiObject.NextSelectionRight|NextSelectionRight` .

GuiObject.NextSelectionDown

設置在遊戲控制器選擇器向下移動時會選擇的 `Class.GuiObject` 。

此屬性設置在使用者將遊戲控制器選擇器移到左側時選擇的   屬性。如果此屬性為空，將遊戲手柄移到左側不會更改選擇的 GUI。

  將遊戲控制器選擇器移到左側將設置 `Class.GuiService.SelectedObject` 為此對象，除非 GUI 不是 `Class.GuiObject.Selectable|Selectable` 。請注意，此屬性可以設為 GUI 元素，即使它不是 `Class.GuiObject.Selectable|Selectable` ，因此您應該確保 GUI 的可選擇屬性值與預期的行為匹配。

  也見 `Class.GuiObject.NextSelectionUp|NextSelectionUp` , `Class.GuiObject.NextSelectionDown|NextSelectionDown` , 及 `Class.GuiObject.NextSelectionRight|NextSelectionRight` .

GuiObject.NextSelectionLeft

設置在遊戲控制器選擇器移動到左側時會選擇的 `Class.GuiObject` 。

此屬性設置在使用者將 `Class.GuiObject` 選擇器移到右側時選擇的 [](/input/gamepad) 。如果此屬性為空，將遊戲手柄移動到右側不會更改選擇的 GUI。

  將遊戲控制器選擇器移動到右側將設置 `Class.GuiService.SelectedObject` 到此對象，除非 GUI 不是 `Class.GuiObject.Selectable|Selectable` 。請注意，此屬性可以設為 GUI 元素，即使它不是 `Class.GuiObject.Selectable|Selectable` ，因此您應該確保 GUI 的可選擇屬性值與預期的行為匹配。

  也見 `Class.GuiObject.NextSelectionUp|NextSelectionUp` , `Class.GuiObject.NextSelectionDown|NextSelectionDown` , 及 `Class.GuiObject.NextSelectionLeft|NextSelectionLeft` .

GuiObject.NextSelectionRight

設置在遊戲控制器選擇器移動到右側時會選擇的 `Class.GuiObject` 。

此屬性設置在使用者移動遊戲控制器選擇器向上時選擇的   屬性。如果此屬性為空，將遊戲手柄向上移動不會更改選擇的 GUI。

  將遊戲控制器選擇器向上移動設置 `Class.GuiService.SelectedObject` 到此對象，除非 GUI 不是 `Class.GuiObject.Selectable|Selectable` 。請注意，此屬性可以設為 GUI 元素，即使它不是 `Class.GuiObject.Selectable|Selectable` ，因此您應該確保 GUI 的可選擇屬性值與預期的行為匹配。

  也見 `Class.GuiObject.NextSelectionDown|NextSelectionDown` , `Class.GuiObject.NextSelectionLeft|NextSelectionLeft` , `Class.GuiObject.NextSelectionRight|NextSelectionRight` .

GuiObject.NextSelectionUp

設置在遊戲控制器選擇器向上移動時會選擇的 `Class.GuiObject` 。

此屬性使用    決定像素和Scalar位置。位置是關於對物件的    中心。

  Scalar位置是相對於父GUI元素的大小，如果有。

  `Datatype.UDim2`的像素部分無論父GUI的大小如何都相同。值代表物件在畫素上的位置。物件的實際像素位置可以從 `Class.GuiBase2d.AbsolutePosition` 屬性中讀取。

GuiObject.Position

決定 `Class.GuiObject` 的像素和向量位置。

此屬性決定 `Class.GuiObject` 旋轉的度數。旋轉是相對於對物件的 **中心** 的， **不是** 的 `Class.GuiObject.AnchorPoint|AnchorPoint`，意味著您無法更改旋轉點。此外，此屬性不兼容 `Class.GuiObject.ClipsDescendants|ClipsDescendants` 。

GuiObject.Rotation

決定旋轉 `Class.GuiObject` 的角度數量。

The example below offers a simple demonstration on how to use the
`Class.GuiObject.Selectable` property to limit when a GUI element can be
selected by the Gamepad navigator.

When a `TextBox` has gains focus, it can be selected. However, when a TextBox
loses focus it can no longer be selected.

Although this is a simple demonstration, the property can also be used to
prevent the navigator from selecting UI elements that exist for cosmetic
rather than functional purposes. For instance, while the buttons on a menu
screen should be selectable, the title image should not be.

此屬性決定是否在使用遊戲控制器導航時選擇 `Class.GuiObject` 儀表板。

  如果此屬性是 `true` ，可以選擇 GUI。選擇 GUI 也會將 `Class.GuiService.SelectedObject` 屬性設置為該物件。

  當這是 `false` 時，無法選擇 GUI 。然而，將此設為 `false` 當使用 GUI 時，將不會卸下它或更改 `Class.GuiService.SelectedObject` 屬性的值。

  添加 `Class.GuiObject.SelectionGained` 和 `Class.GuiObject.SelectionLost` 不會為元素發射。要取消選擇 GuiObject，您必須更改 `Class.GuiService.SelectedObject` 屬性。

  這個屬性有用如果GUI通過屬性，例如這個`Class.GuiObject.NextSelectionUp`、`Class.GuiObject.NextSelectionDown`、`Class.GuiObject|NextSelectionRight`或`Class.GuiObject|NextSelectionLeft`連接到多個GUI。而不是改變所有的屬性，使遊戲手柄無法選擇 GUI，您可以暫時禁用其可選屬性，以防止它被選擇。然後，當您想要遊戲控制器能夠選擇 GUI 時，只需重新啟用其可選擇的屬性即可。

GuiObject.Selectable

確定是否可以由遊戲控制器選擇 `Class.GuiObject` 。

此屬性覆蓋了用於遊戲板的預設選擇裝飾。

  請注意，選擇的 `Class.GuiObject.SelectionImageObject|SelectionImageObject` 覆蓋了選擇的 `Class.GuiObject` 以圖像的 `Class.GuiObject.Size|Size` 。為了獲得最佳效果，您應該通過比例 `SelectionImageObject` 值將自訂 `Datatype.UDim2` 縮放到選定的元素上，以幫助確保對象正確縮放。

  變更 `Class.GuiObject.SelectionImageObject|SelectionImageObject` 對於 `Class.GuiObject` 元素只會影響該元素。若要影響使用者所有的 GUI 元素，請設置 `Class.PlayerGui.SelectionImageObject` 屬性。

  若要確定使用者選擇哪個 GUI 元素，您可以使用 `Class.GuiService.SelectedObject` 屬性。玩家使用遊戲手柄選擇不同的 GUI 元素，召喚 `Class.GuiObject.NextSelectionUp|NextSelectionUp` , `Class.GuiObject.NextSelectionDown|NextSelectionDown` , `Class.GuiObject.NextSelectionLeft|NextSelectionLeft` 和 `Class.GuiObject.NextSelectionRight|NextSelectionRight` 事件。

GuiObject.SelectionImageObject

覆蓋使用於遊戲板的預設選擇裝飾。

具有較低選擇順序的 GuiObject 在開始遊戲控制器選擇或呼叫祖先 `Class.GuiService:Select()` 時，會先選擇具有較低選擇順序的 GuiObject 而不是具有較高選擇順序的 GuiObject。此屬性不會影響方向導航。預設值為 0。

GuiObject.SelectionOrder

由遊戲控制器介面選擇所選擇的 `Class.GuiObject|GuiObjects` 順序。

This code sample allows you to create a simple color-changing health bar using
two nested Frames. Paste this into a LocalScript on the inner frame.

此屬性使用 `Class.GuiObject` 決定Scalar和像素尺寸，使用 `Datatype.UDim2` 。

  Scalar 尺寸與父 GUI 元素的尺寸相對，如果有。

  `Datatype.UDim2`的像素部分無論父GUI的大小如何都相同。值代表物件的像素大小。對象的實際像素尺寸可以從 `Class.GuiBase2d.AbsoluteSize` 屬性中讀取。

  如果 `Class.GuiObject` 有一個父元素，其各軸的尺寸也會受到父父元素的 `Class.GuiObject.SizeConstraint|SizeConstraint` 影響。

GuiObject.Size

決定 `Class.GuiObject` 的像素和積分尺寸。

對所有 2D 使用者介面對象的抽象類。