`InputActionLabel` 是一个拖放的 `Class.GuiObject`，根据玩家当前的输入设备（键盘/鼠标、游戏手柄、触摸、VR）自动显示适当的键或图标。当玩家切换设备或重新绑定时，标签会立即更新，无需脚本。

`InputActionLabel` 的渲染依赖于 `Class.InputAction`（通过 `Class.InputActionLabel.InputAction` 关联）及该动作的子 `Class.InputBinding|InputBindings`。标签解析要显示的内容时，遵循以下顺序：

1. **自定义图像** — 如果子 `Class.InputBinding|InputBindings` 的 `Class.InputBinding.DisplayImage|DisplayImage` 属性被设置，标签会直接渲染这些图像，可能会被 `Class.InputActionLabel.ImageColor3|ImageColor3` 和 `Class.InputActionLabel.ImageTransparency|ImageTransparency` 修改。

2. **平台键图像** — 如果没有自定义图像，标签会通过 `Class.UserInputService:GetImageForKeyCode()` 渲染平台提供的子 `Class.InputBinding|InputBindings` 图像（如果有可用图像）。复合绑定与修饰符会显示多个图标，并用 `+` 分隔。

3. **自定义名称** — 如果没有可用图像，且子 `Class.InputBinding|InputBindings` 的 `Class.InputBinding.DisplayName|DisplayName` 属性被设置，标签会以 `Class.InputActionLabel.FontFace|FontFace`、`Class.InputActionLabel.TextColor3|TextColor3`、`Class.InputActionLabel.TextSize|TextSize`、`Class.InputActionLabel.TextTransparency|TextTransparency`、`Class.InputActionLabel.TextWrapped|TextWrapped`、`Class.InputActionLabel.TextXAlignment|TextXAlignment` 和 `Class.InputActionLabel.TextYAlignment|TextYAlignment` 定义的样式渲染该文本。

4. **平台键字符串** — 如果以上都没有，标签会通过 `Class.UserInputService:GetStringForKeyCode()` 渲染平台提供的字符串。

5. 如果没有分配 `Class.InputAction` 或没有子 `Class.InputBinding`，标签会渲染一个占位符图标。


InputActionLabel

此属性类似于 `Class.TextLabel.FontFace`，确定在标签以文本模式渲染时使用的字体系列、粗细和样式。


InputActionLabel.FontFace

此属性确定标签图像的上色方式。当设置为白色时，不会进行上色。此属性对于重用图像资产非常有用；如果源图像完全是白色且带有透明度，可以通过此属性一次性设置整个标签的颜色。


InputActionLabel.ImageColor3

确定渲染的标签图像将如何上色。


此属性确定渲染的标签图像的 alpha 值。值为 `0` 时完全不透明，值为 `1` 时完全透明（不可见）。


InputActionLabel.ImageTransparency

确定渲染的标签图像的透明度。


要自动解析并显示其首选绑定的 `Class.InputAction` 实例。当绑定更改（由于重新绑定或输入设备切换）时，标签会自动更新。

将此设置为 `nil` 会清除显示并显示占位符。


InputActionLabel.InputAction

显示此标签的首选绑定的 `Class.InputAction`。


包含标签在图像模式下渲染时的第一个解析图像的 `Datatype.Content`。在文本或占位符模式下为空。此属性是由引擎在绑定解析时设置的只读属性。


InputActionLabel.ResolvedImageContent

只读。当前显示的解析图像内容。


包含组合键名字符串，例如 `Ctrl + Shift + Space`，当标签在文本模式下渲染时。标签在图像或占位符模式下为空。此属性是由引擎在绑定解析时设置的只读属性。


InputActionLabel.ResolvedText

此属性确定标签渲染的所有文本的颜色。


InputActionLabel.TextColor3

控制文本模式渲染的字体大小（以像素为单位）。值限制在 `1` 和 `200` 之间。


InputActionLabel.TextSize

此属性确定标签渲染的所有文本的透明度。


InputActionLabel.TextTransparency

当 `true` 时，文本在标签的空间内换行，以便 `Class.InputActionLabel.TextSize|TextSize` 行不会超过对象的 `Class.GuiBase2d.AbsoluteSize`。这是通过将长文本行拆分为多行来实现的。


InputActionLabel.TextWrapped

确定文本是否在标签的空间内换行。


此属性确定在标签的空间内渲染文本的水平对齐方式。


InputActionLabel.TextXAlignment

确定渲染文本的水平对齐方式。


此属性确定在标签的空间内渲染文本的垂直对齐方式。


InputActionLabel.TextYAlignment

确定渲染文本的垂直对齐方式。


一个 `Class.GuiObject`，自动以文本或图像的形式显示操作的按键绑定。


`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)，并且可以通过 [appearance modifiers](/ui/appearance-modifiers) 超出其核心属性进行样式设置。

虽然可以使用 `Class.GuiObject.InputBegan|InputBegan` 和 `Class.GuiObject.InputEnded|InputEnded` 检测任何 GUI 对象上的鼠标按钮事件，
但只有 `Class.ImageButton` 和 `Class.TextButton` 具有方便的专用事件，例如 `Class.TextButton.Activated|Activated` 来检测点击/按压。

以下示例假设它在一个 GuiObject 中，例如 `TextButton`，并且
`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_ 的子对象。


当用户停止通过人机界面设备（鼠标按钮按下，触摸开始，键盘按钮按下等）交互时触发。

`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` 元素中时触发。

请不要依赖此事件传递的 `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 的确切时刻。

即使 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` 偏移量。
`Class.GuiObject.AbsolutePosition|AbsolutePosition` 是在屏幕的 GUI 内嵌中测量的，而此事件的 `x` 和 `y` 参数是包含它的屏幕坐标，因此示例调用 `Class.GuiService:GetGuiInset()|GetGuiInset()` 来调和这两个空间，而不是假设固定的内嵌大小。

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

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

local mouse = Players.LocalPlayer:GetMouse()

local function getPosition(X, Y)
	local topLeftInset = GuiService:GetGuiInset()

	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 - topLeftInset.Y))
	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 元素上向前滚动鼠标滚轮时触发。

以下示例在用户使用游戏手柄选择对象时打印一条消息。

为了使其按预期工作，它必须放置在 `LocalScript` 中，并且是 _gui_ 的子对象。


当游戏手柄选择器开始聚焦于 `Class.GuiObject` 时触发。

如果您想检查游戏手柄选择停止聚焦于 GUI 元素，可以使用 `Class.GuiObject.SelectionLost` 事件。

当 GUI 获得选择焦点时，`Class.GuiService.SelectedObject|SelectedObject` 属性的值也会更改为获得选择的对象。要确定哪个 GUI 获得了选择，请检查此属性的值。

GuiObject.SelectionGained

当 GuiObject 被游戏手柄选择器聚焦时触发。

以下示例在元素失去焦点时打印一条消息，
在游戏手柄上。

为了使其按预期工作，它必须放置在 `LocalScript` 中，
并且是 _gui_ 的子项。


当游戏手柄选择器停止聚焦于 `Class.GuiObject` 时触发。

如果您想检查游戏手柄选择开始聚焦于 GUI 元素，可以使用 `Class.GuiObject.SelectionGained` 事件。

当 GUI 失去选择焦点时，`Class.GuiService.SelectionObject|SelectionObject` 属性的值会更改为 `nil` 或获得选择焦点的 GUI 元素。要确定哪个 GUI 获得了选择，或者如果没有 GUI 被选中，请检查此属性的值。

GuiObject.SelectionLost

当游戏手柄选择器停止聚焦于 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 元素时触发。

此代码示例旨在放置在一个 `LocalScript` 中，该脚本位于一个内部 `Frame` 中，而该内部 `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`，或其他 `GuiObject`。它允许玩家通过在外部框架上执行 `Class.GuiObject.TouchPinch` 手势来缩放内部框架。


当玩家使用两个手指在 UI 元素上执行捏合或拉动手势时触发。**捏合**发生在两个或更多手指靠近时，**拉动**发生在它们分开时。此事件与 `Class.GuiObject.TouchPan` 一起触发。此事件对于允许玩家操纵屏幕上 UI 元素的缩放（大小）非常有用，通常用于缩放功能。

此事件会触发一个描述参与手势的手指相对屏幕位置的 `Datatype.Vector2` 表。并且，它会多次触发：在短暂延迟后触发 `Enum.UserInputState.Begin`，在玩家在手势期间移动手指时触发 `Enum.UserInputState.Change`，最后在 `Enum.UserInputState.End` 时触发。应注意，缩放应 **乘法** 使用。

GuiObject.TouchPinch

一个 Luau 数组，包含 `Datatype.Vector2` 对象，每个对象指示参与捏合手势的所有手指的位置。

scale

一个浮点数，指示与捏合手势开始时的差异。

一个浮点数，指示捏合手势发生的速度。

当玩家使用两个手指在 UI 元素上执行捏合或拉动手势时触发。

此代码示例适用于一个位于外部 `Frame` 内部的 `LocalScript`，或其他 `GuiObject`。它允许玩家通过在外部框架上执行 `Class.GuiObject.TouchRotate` 手势来旋转内部框架。


当玩家使用两个手指在触摸设备上对 UI 元素进行捏合或拉动手势时，此事件触发。当两个手指之间的线的角度发生变化时，旋转发生。此事件与 `Class.GuiObject.TouchPan` 一起触发。此事件对于允许玩家操控屏幕上 UI 元素的旋转非常有用。

此事件触发时会带有一个 `Datatype.Vector2` 的表，描述参与手势的手指的相对屏幕位置。此外，它会多次触发：在短暂延迟后触发 `Enum.UserInputState.Begin`，在玩家在手势中移动手指时触发 `Enum.UserInputState.Change`，最后触发 `Enum.UserInputState.End`。

GuiObject.TouchRotate

一个 Luau 数组，包含 `Datatype.Vector2` 对象，每个对象表示参与手势的所有手指的位置。

rotation

一个浮点数，表示旋转从手势开始时的变化量。

一个浮点数，表示手势执行的速度。

当玩家在 UI 元素上使用两个手指执行旋转手势时触发。

此代码示例将在触摸设备（或Studio的模拟器）上执行滑动手势时使`Frame`（或其他`GuiObject`）弹跳。
水平滑动将改变`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

当玩家在 UI 元素上执行点击手势时触发。

此代码示例演示了通过定义回调函数来检测平滑过渡何时完成/取消，从而更复杂地使用 TweenPosition。它还打印平滑过渡是否会播放。


平滑地将 GUI 移动到指定时间内的新 `Datatype.UDim2` 位置，使用指定的 `Enum.EasingDirection` 和 `Enum.EasingStyle`。

此函数将返回 tween 是否会播放。如果另一个 tween 正在作用于 `Class.GuiObject` 且覆盖参数为 `false`，则不会播放。

另请参见 `Class.GuiObject:TweenSize()` 和 `Class.GuiObject:TweenSizeAndPosition()`。

GuiObject:TweenPosition

endPosition

easingDirection

将 GUI 缓和到 _endPosition_ 的方向。

easingStyle

将 GUI 缓和到 _endPosition_ 的样式。

time

缓和完成所需的时间（以秒为单位）。

override

缓和是否会覆盖正在进行的缓和。

callback

缓和完成时要执行的回调函数。

平滑地将 GUI 移动到新的 `Datatype.UDim2`。

此代码示例演示了 `Class.GuiObject:TweenSize()`
函数的用法。它在父对象的 `Class.GuiObject.Size`
属性上启动动画，目标为 `UDim2.new(0.5, 0, 0.5, 0)`，这表示在两个轴上都是 `GuiObject` 的一半
父对象大小。

此外，它演示了如何使用回调参数来检测
当补间动画停止时（无论是被另一个补间动画取消还是完成）。


平滑地将 `Class.GuiObject` 调整大小到新的 `Datatype.UDim2`，在指定时间内使用指定的 `Enum.EasingDirection` 和 `Enum.EasingStyle`。

此函数将返回缓和是否会播放。通常这将始终返回 `true`，但如果另一个缓和处于活动状态且覆盖设置为 `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`。

此函数将返回缓和是否会播放。通常这将始终返回 `true`，但如果另一个缓和处于活动状态且覆盖设置为 `false`，则将返回 `false`。

另请参见 `Class.GuiObject:TweenSize()` 和 `Class.GuiObject:TweenSizeAndPosition()`。

GuiObject:TweenSizeAndPosition

将 GUI 缓和到 _endSize_ 和 _endPosition_ 的方向。

将 GUI 缓和到 _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 元素移动到父元素的不同侧面。
它从左上角开始，结束于右下角。将其粘贴到
ScreenGui 中的 Frame 的 LocalScript 中。


此属性确定 `Class.GuiObject` 的原点，相对于其绝对大小。原点确定元素的位置（通过 `Class.GuiObject.Position`）以及渲染的 `Class.GuiObject.Size` 从何处扩展。

有关插图和详细信息，请参见 [这里](/ui/position-and-size#anchorpoint)。

GuiObject.AnchorPoint

确定 `Class.GuiObject` 的原点，相对于其绝对大小。

以下脚本创建一个自动调整大小的父框架，带有`UIListLayout`，然后插入几个自动调整大小的`TextLabel`对象。注意父`UIListLayout`如何自动调整大小以适应其子内容，以及标签如何自动调整大小以适应其文本内容。此脚本可以作为`ScreenGui`的子对象。

此属性用于根据其后代的大小自动调整父 UI 对象的大小。您可以使用此属性在编辑或运行时动态添加文本和其他内容到 UI 对象，大小将调整以适应该内容。

当 `Class.GuiObject.AutomaticSize|AutomaticSize` 设置为 `Enum.AutomaticSize` 的值时，除了 `Enum.AutomaticSize|None`，此 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.StarterGui.ClipsDescendantsSupportsRotation` 启用时，剪裁对于旋转的形状工作正常。然而，旋转形状（当剪裁父本身旋转时）或圆角（`Class.UICorner`）的剪裁不受支持。

当 `Class.StarterGui.ClipsDescendantsSupportsRotation` **未** 启用，并且此 `Class.GuiObject` 或任何祖先 `Class.GuiObject` 具有 **非零** `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` 上被按下。

控制 `Class.GuiObject` 接收发生在其上的输入的方式和程度，使用 `Enum.InputSink`。接收输入会阻止其传递给元素后面的对象，包括世界中的 3D 对象，例如带有 `Class.ClickDetector` 或 `Class.DragDetector` 的对象。默认值为 `Enum.InputSink.None`，但在 `Class.GuiButton` 对象（`Class.ImageButton` 和 `Class.TextButton`）上，默认值为 `Enum.InputSink.Activate`。

- `Enum.InputSink.None` — 对象本身不接收输入。
- `Enum.InputSink.Activate` — 对象接收用于激活它的鼠标按钮和触摸按下/释放输入，但允许其他输入（例如鼠标移动）通过。
- `Enum.InputSink.All` — 对象接收发生在其上的所有输入。

此属性是布尔 `Class.GuiObject.Active|Active` 属性的更细粒度的继承者，后者只能接收所有输入或不接收。`Class.GuiObject.InputBegan|InputBegan`、`Class.GuiObject.InputChanged|InputChanged` 和 `Class.GuiObject.InputEnded|InputEnded` 事件无论此属性的值如何都会触发。

GuiObject.InputSink

控制 `Class.GuiObject` 如何以及是否接收发生在其上的输入。

确定 `Class.GuiButton` 是否可以与之交互，或者 `Class.GuiObject` 的 `Enum.GuiState|GuiState` 是否正在变化。

在 `Class.GuiButton` 上：

- 当 `Class.GuiObject.Interactable|Interactable` 设置为 `false` 时，`Class.GuiButton` 将不再能够被按下或点击，且 `Class.GuiObject.GuiState|GuiState` 将始终设置为 `Enum.GuiState.NonInteractable|NonInteractable`。
- 当 `Class.GuiObject.Interactable|Interactable` 设置为 `true` 时，`Class.GuiButton` 将恢复正常行为，`Class.GuiObject.GuiState|GuiState` 也将恢复正常。

在 `Class.GuiObject` 上：

- 当 `Class.GuiObject.Interactable|Interactable` 设置为 `false` 时，`Class.GuiObject.GuiState|GuiState` 将始终设置为 `Enum.GuiState.NonInteractable|NonInteractable`。
- 当 `Class.GuiObject.Interactable|Interactable` 设置为 `true` 时，`Class.GuiObject.GuiState|GuiState` 将恢复正常行为。

GuiObject.Interactable

确定 `Class.GuiButton` 是否可以与之交互，或者 `Class.GuiObject` 的 `Enum.GuiState|GuiState` 是否正在变化。

所有 2D 用户界面对象的抽象类。

/reference/engine/classes/InputActionLabel.yaml

摘要