GuiButton 是一个抽象类，继承自 GuiObject 。它是互动、可点击的 ImageButton 和 TextButton 对象的基础类。此类还定义了几个用于互动行为的属性，即 AutoButtonColor 和 Modal 。
一个 GuiButton 最重要的事件是 Activated , 一个 多平台事件 ，当按钮激活时触发。当使用鼠标时，这意味着单击按钮并释放鼠标仍在 UI 对象上时释放按钮。对于触摸，同样适用，但使用触摸而不是按钮按按住。最后，对于游戏手柄，Activated 在按下和释放 GuiButton 按钮时，如果选择了 **** ，将发生火灾。总之，这个事件对多平台用户界面编程非常有用，因为它为单个用户输入提供了一个很好的通用界面。
概要
属性
决定是否当鼠标悬停或单击时，按钮会自动更改颜色。
当 被悬停时会播放的实例。
如果 true 在图形用户界面元素可见时，鼠标不会锁定，除非右键按钮向下。
一个当 HapticEffect 按下时会播放的实例，当 GuiButton 按下时。
一个指示对象是否已选择的 boolean 属性。
根据一列预定义风格设置 GuiButton 的风格。
决定这个 UI 元素是否沉没输入。
确定 GuiObject 的起始点，相对于其绝对尺寸。
决定是否基于子内容进行缩放。
决定 GuiObject 背景颜色。
决定 GuiObject 背景和边界的透明度。
决定 GuiObject 边框的颜色。
决定边界 GuiObject 是如何相对于其尺寸布置。
决定 GuiObject 边框的像素宽度。
决定是否描渲染父级 GUI 元素边界外的子元素 GuiObjects。
决定玩家的鼠标是否在 GuiObject 上被主动按下。
控制使用 GuiObject 与 UIGridStyleLayout 时的排序顺序。
设置当游戏手柄选择器向下移动时将选择的 GuiObject 。
设置当游戏手柄选择器移至左侧时将选择的 GuiObject 。
设置当游戏手柄选择器移至右侧时将选择的 GuiObject 。
设置当游戏手柄选择器向上移动时将选择的 GuiObject 。
确定 GuiObject 的像素和坐标位置。
决定旋转 GuiObject 的角度数。
确定是否可以由游戏手柄选择 GuiObject 。
覆盖用于游戏手柄的默认选择装饰。
游戏手柄 UI 选择选择的 GuiObjects 顺序。
决定 GuiObject 的像素和积分尺寸。
混合属性 BackgroundTransparency 和 TextTransparency 。
决定是否渲染 GuiObject 和其子孙。
决定 GuiObject 对其他人的相对渲染顺序。
方法
继承自GuiObject的方法- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
平滑地将图形用户界面移至新的 UDim2 。
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
平滑地将图形用户界面移至新的尺寸和位置。
活动
当按钮激活时发火。
当用户的鼠标完全点击 GuiButton 时发生火焰。
当用户按下左键时，在 GuiButton 上按下左键时发生火焰。
当用户释放左鼠标按钮时，发生在 GuiButton 上。
当用户的鼠标完全右键单击 GuiButton 时发生火焰。
当用户按下鼠标右键向下在 GuiButton 上时，发生火焰。
当用户释放鼠标右键时，火焰从 GuiButton 上。
当用户开始通过人机界面设备（鼠标按钮向下、触摸开始、键盘按钮向下等）进行交互时，发射。
当用户通过人机界面设备（鼠标按钮向下、触摸开始、键盘按钮向下等）更改他们的互动方式时，发射。
当用户停止通过人机界面设备（鼠标按钮向下、触摸开始、键盘按钮向下等）进行交互时，发射。
当用户将鼠标移至图形用户界面元素时发生火焰。
当用户将鼠标移出 GUI 元素时发生火焰。
在用户移动鼠标时，无论它在哪个 GUI 元素内，都会发生火焰。
当用户滚动鼠标轮返回时，火焰当鼠标悬停在图形用户界面元素上。
当用户滚动鼠标轮时向前移动时，触发当鼠标悬停在图形用户界面元素上时。
在使用游戏手柄选择器时将 GuiObject 聚焦时发射。
当游戏手柄选择器停止关注 GuiObject 时发射。
当玩家开始、继续和停止长按 UI 元素时，发生火焰。
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
当玩家在 UI 元素上移动手指时发生火焰。
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
当玩家使用界面元素上的两个手指执行捏或拉动动作时，发生火焰。
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
当玩家使用界面元素上的两个手指执行旋转动作时，发生火焰。
当玩家在 UI 元素上执行滑动动作时发生火焰。
当玩家在 UI 元素上执行了点击动作时发生火焰。
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
当游戏手柄选择移动到、离开或在连接的 或任何子手柄中更改时，发生火焰。
属性
AutoButtonColor
该属性决定是否当用户的 Mouse 将鼠标悬停或单击时，按钮会自动更改颜色。如果 true , 按钮将在鼠标悬停或单击时自动更改颜色。如果 false , 按钮不会更改。
如果您想自定义用户的鼠标悬停或单击按钮时按钮的变化方式,请考虑使用 ImageButton 并修改元素的 HoverImage 和 PressedImage。
请注意，如果其 Image 属性设置为图像，这个属性将不会对 ImageButton 产生影响。此外，此属性不会影响鼠标悬停时的 ImageButton 或单击鼠标时的 HoverImage ，如果其 nil 不是 PressedImage ，也不会影响单击鼠标时的 nil 。
方法
活动
MouseButton1Click
当用户的鼠标完全离开单击 GuiButton 时，此事件发生
对于单击，鼠标必须在 GuiButton 范围内，鼠标按钮必须在此事件触发前按下并再次向下。如果鼠标离开了 GuiButton 的边界并被释放，事件不会发射。如果您想避免这种限制，您可以使用 MouseButton1Down 和 MouseButton1Up；这些事件相似，但会在用户分别按下左键或向上或向下按钮时触发。
MouseButton2Click
当用户的鼠标完全右键单击 GuiButton 时，此事件发生
对于单击，鼠标必须在 GuiButton 范围内，鼠标按钮必须在此事件触发前按下并再次向下。如果鼠标离开了 GuiButton 的边界并被释放，事件不会发射。如果您想避免这种限制，您可以使用 MouseButton2Down 和 MouseButton2Up；这些事件相似，但会在用户分别按下或向上或向下右键时触发。