Appearance
Button states and effects
使用任何对象作为按钮，并根据用户交互改变外观。
作者和贡献者：D8H。
使用“按钮状态”行为跟踪对象的用户交互，包括：
- 悬停
- 按下
- 点击
- 空闲
添加其他行为，以创建具有动画响应用户输入的生动按钮：
- 大小
- 颜色
- 动画
- 物体效果
提示
按照逐步指南，了解如何安装新的扩展。
按钮动画
根据按钮的状态更改按钮的动画。
行为动作
焦点状态动画名称 更改对象的焦点状态动画名称。当按钮悬停或在外部按住时，状态为焦点。
空闲状态动画名称 更改对象的空闲状态动画名称。
按下状态动画名称 更改对象的按下状态动画名称。
行为条件
焦点状态动画名称 比较对象的焦点状态动画名称。当按钮悬停或在外部按住时，状态为焦点。
空闲状态动画名称 比较对象的空闲状态动画名称。
按下状态动画名称 比较对象的按下状态动画名称。
行为表达式
表达式
描述
Object.ButtonAnimationName::FocusedAnimationName()
返回对象的焦点状态动画名称。当按钮悬停或在外部按住时，状态为焦点。
Object.ButtonAnimationName::IdleAnimationName()
返回对象的空闲状态动画名称。
Object.ButtonAnimationName::PressedAnimationName()
返回对象的按下状态动画名称。
按钮颜色渐变
根据按钮的状态平滑改变按钮的颜色渐变。
行为动作
淡入持续时间 更改对象的淡入持续时间。
淡入缓动 更改对象的淡入缓动。
淡出持续时间 更改对象的淡出持续时间。
淡出缓动 更改对象的淡出缓动。
焦点状态颜色渐变 更改对象的焦点状态颜色渐变。当按钮悬停或在外部按住时，状态为焦点。
空闲状态颜色渐变 更改对象的空闲状态颜色渐变。
按下状态颜色渐变 更改对象的按下状态颜色渐变。
行为条件
淡入持续时间 比较对象的淡入持续时间。
淡入缓动 比较对象的淡入缓动。
淡出持续时间 比较对象的淡出持续时间。
淡出缓动 比较对象的淡出缓动。### 淡出缓动 比较对象的淡出缓动。
聚焦状态着色
比较对象的聚焦状态着色。当按钮被悬停或按住时，状态为聚焦。
空闲状态着色
比较对象的空闲状态着色。
按下状态着色
比较对象的按下状态着色。
行为表达式
表达式
描述
Object.ButtonColorTintTween::FadeInDuration()
返回对象的淡入持续时间。
Object.ButtonColorTintTween::FadeInEasing()
返回对象的淡入缓动。
Object.ButtonColorTintTween::FadeOutDuration()
返回对象的淡出持续时间。
Object.ButtonColorTintTween::FadeOutEasing()
返回对象的淡出缓动。
Object.ButtonColorTintTween::FocusedColorTint()
返回对象的聚焦状态着色。当按钮被悬停或按住时，状态为聚焦。
Object.ButtonColorTintTween::IdleColorTint()
返回对象的空闲状态着色。
Object.ButtonColorTintTween::PressedColorTint()
返回对象的按下状态着色。
按钮状态
使用对象作为按钮。
行为条件
是否点击
检查按钮是否刚刚被点击。
是否聚焦
检查按钮是否处于悬停或按下但未悬停状态。
是否悬停
检查光标是否悬停在按钮上方。
是否空闲
检查按钮是否未被使用。
是否按下
检查按钮当前是否被鼠标或触摸按下。
是否在外按住
检查按钮当前是否被鼠标或触摸按住在外面。
触摸ID
比较正在使用按钮的触摸ID，如果没有，则为0。
行为表达式
表达式
描述
Object.ButtonFSM::TouchId()
返回正在使用按钮的触摸ID，如果没有，则为0。
按钮对象效果补间
根据其状态平滑更改按钮上的效果。
行为动作
效果参数
更改对象的效果参数。效果参数名称可以在效果选项卡中的下拉菜单的“显示参数名称”操作中找到。
淡入持续时间
更改对象的淡入持续时间。
淡入缓动
更改对象的淡入缓动。
淡出持续时间
更改对象的淡出持续时间。
淡出缓动
更改对象的淡出缓动。
聚焦效果参数值
更改对象的聚焦效果参数值。当按钮被悬停或按住时，状态为聚焦。
空闲效果参数值
更改对象的空闲效果参数值。
按下效果参数值
更改对象的按下效果参数值。
行为条件
效果名称
比较对象的效果名称。
效果参数
比较对象的效果参数。效果参数名称可以在效果选项卡中的下拉菜单的“显示参数名称”操作中找到。
淡入时长 比较对象的淡入时长。
淡入缓动 比较对象的淡入缓动。
淡出时长 比较对象的淡出时长。
淡出缓动 比较对象的淡出缓动。
聚焦效果参数值 比较对象的聚焦效果参数值。当按钮悬停或按住在外部时，状态为聚焦。
空闲效果参数值 比较对象的空闲效果参数值。
按下效果参数值 比较对象的按下效果参数值。
行为表达式
表达式
描述
Object.ButtonObjectEffectTween::EffectName()
返回对象的效果名称。
Object.ButtonObjectEffectTween::EffectProperty()
返回对象的效果参数。效果参数名称可在下拉菜单的“显示参数名称”操作中的效果选项卡中找到。
Object.ButtonObjectEffectTween::FadeInDuration()
返回对象的淡入时长。
Object.ButtonObjectEffectTween::FadeInEasing()
返回对象的淡入缓动。
Object.ButtonObjectEffectTween::FadeOutDuration()
返回对象的淡出时长。
Object.ButtonObjectEffectTween::FadeOutEasing()
返回对象的淡出缓动。
Object.ButtonObjectEffectTween::FocusedValue()
返回对象的聚焦效果参数值。当按钮悬停或按住在外部时，状态为聚焦。
Object.ButtonObjectEffectTween::IdleValue()
返回对象的空闲效果参数值。
Object.ButtonObjectEffectTween::PressedValue()
返回对象的按下效果参数值。
按钮对象效果
根据其状态在按钮上启用效果。
行为动作
聚焦状态效果 更改对象的聚焦状态效果。当按钮悬停或按住在外部时，状态为聚焦。
空闲状态效果 更改对象的空闲状态效果。
按下状态效果 更改对象的按下状态效果。
行为条件
聚焦状态效果 比较对象的聚焦状态效果。当按钮悬停或按住在外部时，状态为聚焦。
空闲状态效果 比较对象的空闲状态效果。
按下状态效果 比较对象的按下状态效果。
行为表达式
表达式
描述
Object.ButtonObjectEffects::FocusedEffect()
返回对象的聚焦状态效果。当按钮悬停或按住在外部时，状态为聚焦。
Object.ButtonObjectEffects::IdleEffect()
返回对象的空闲状态效果。
Object.ButtonObjectEffects::PressedEffect()
返回对象的按下状态效果。
按钮缩放Tween
根据其状态平滑调整按钮的大小。
行为动作
淡入时长 更改对象的淡入时长。#### 渐变效果
淡入缓动 更改对象的淡入缓动。
淡出持续时间 更改对象的淡出持续时间。
淡出缓动 更改对象的淡出缓动。
焦点状态大小比例 更改对象的焦点状态大小比例。当鼠标悬停或保持在按钮外部时，状态为焦点。
闲置状态大小比例 更改对象的闲置状态大小比例。
按下状态大小比例 更改对象的按下状态大小比例。
行为条件
淡入持续时间 比较对象的淡入持续时间。
淡入缓动 比较对象的淡入缓动。
淡出持续时间 比较对象的淡出持续时间。
淡出缓动 比较对象的淡出缓动。
焦点状态大小比例 比较对象的焦点状态大小比例。当鼠标悬停或保持在按钮外部时，状态为焦点。
闲置状态大小比例 比较对象的闲置状态大小比例。
按下状态大小比例 比较对象的按下状态大小比例。
行为表达式
表达式
描述
Object.ButtonScaleTween::FadeInDuration()
返回对象的淡入持续时间。
Object.ButtonScaleTween::FadeInEasing()
返回对象的淡入缓动。
Object.ButtonScaleTween::FadeOutDuration()
返回对象的淡出持续时间。
Object.ButtonScaleTween::FadeOutEasing()
返回对象的淡出缓动。
Object.ButtonScaleTween::FocusedScale()
返回对象的焦点状态大小比例。当鼠标悬停或保持在按钮外部时，状态为焦点。
Object.ButtonScaleTween::IdleScale()
返回对象的闲置状态大小比例。
Object.ButtonScaleTween::PressedScale()
返回对象的按下状态大小比例。
该页面是一个由社区创建的关于 按钮状态和效果 扩展的自动生成参考页面，由为每个人设计的开源跨平台游戏引擎GDevelop的社区提供。