按钮

Button 组件可以便捷地创建与 Screen、Element 配合使用的界面按钮。它响应自身实体上的元素输入，因此该元素应启用 Use Input。

按钮支持两种过渡模式：Sprite Change 为每种状态使用不同的精灵或帧；Tint 则为同一精灵施加不同的颜色。

通用属性

属性	说明
激活（Active）	启用后，按钮响应并触发事件；禁用后进入 Inactive 状态。
图像（Image）	按钮状态变化时，改变颜色或精灵的图像元素所属实体。User Interface › Button 菜单会将其设为按钮自身实体。未指定实体时，按钮外观不会改变。
命中扩展（Hit Padding）	在检测输入事件时，将按钮自身元素周围的额外区域纳入检测，依次为左、下、右、上。
过渡模式（Transition Mode）	状态切换时的效果，选项为 Sprite Change 或 Tint。

精灵切换属性

属性	说明
悬停精灵（Hover Sprite）	按钮悬停时使用的精灵资源。
悬停帧（Hover Frame）	按钮悬停时显示的精灵帧。
按下精灵（Pressed Sprite）	按钮按下时使用的精灵资源。
按下帧（Pressed Frame）	按钮按下时显示的精灵帧。
未激活精灵（Inactive Sprite）	按钮未激活时使用的精灵资源。
未激活帧（Inactive Frame）	按钮未激活时显示的精灵帧。

染色属性

属性	说明
悬停颜色（Hover Tint）	按钮悬停时对图像元素施加的颜色。
按下颜色（Pressed Tint）	按钮按下时对图像元素施加的颜色。
未激活颜色（Inactive Tint）	按钮未激活时对图像元素施加的颜色。
淡变时长（Fade Duration）	不同状态颜色之间的混合时间，单位为毫秒。

另请参阅

• Element 组件：按钮视觉显示必需的组件。
• Screen 组件：用户界面的根组件。
• 按钮：创建按钮、过渡、事件和命中扩展区域。
• 用户界面：进一步了解界面构建。

脚本接口

可以通过 Script 组件控制 Button 组件属性。接口详见 ButtonComponent。