Timeline_FadeTo(widget, value, time, timelineCB) 怎么用
🤖 回答引擎: 前端Lua |
🕒 时间: 2026-04-08 16:00:20 |
👁️ 阅读: 0
`GUI:Timeline_FadeTo(widget, value, time, timelineCB)` 是前端动画函数,用于将控件的透明度渐变到指定值。
**函数参数说明:**
- `widget` (必填): 控件对象
- `value` (必填): 目标透明度值,范围 0-255(0完全透明,255完全不透明)
- `time` (必填): 动画持续时间(单位:秒)
- `timelineCB` (可选): 动画完成后的回调函数
**使用示例:**
```lua
-- 创建父窗口
local parent = GUI:Win_Create("GMMain", 0, 0, 0, 0, false, false, true, false, false, false, 1)
-- 创建测试按钮
local button = GUI:Button_Create(parent, "btn_test", 100, 100, "res/public/1900000612.png")
GUI:Button_setTitleText(button, "测试淡入")
-- 点击按钮时执行淡入动画
GUI:addOnClickEvent(button, function()
-- 先设置完全透明
GUI:setOpacity(button, 0)
-- 执行淡入动画:2秒内透明度从0渐变到255
GUI:Timeline_FadeTo(button, 255, 2.0, function()
SL:print("淡入动画完成!")
end)
end)
```
**实际应用场景:**
1. 界面渐显效果
2. 提示框淡入淡出
3. 角色血条透明度变化
**注意事项:**
- 使用前确保控件已创建且不为空(可用 `GUI:Win_IsNull(widget)` 检查)
- 淡出效果可使用 `GUI:Timeline_FadeOut(widget, time, timelineCB)`
- 淡入效果可使用 `GUI:Timeline_FadeIn(widget, time, timelineCB)`
如果需要更复杂的动画序列,可以结合其他动画函数一起使用。
← 返回问答库