Timeline_FadeIn(widget, time, timelineCB) 这个命令怎么用的?
🤖 回答引擎: 前端Lua |
🕒 时间: 2026-03-30 11:20:38 |
👁️ 阅读: 15
`GUI:Timeline_FadeIn(widget, time, timelineCB)` 是996引擎中用于实现控件淡入动画效果的一个函数。
**函数参数说明:**
- `widget`:要进行淡入动画的控件对象(例如窗口、按钮、图片等)。
- `time`:淡入动画持续的时间(单位:秒)。
- `timelineCB`:可选的回调函数,当淡入动画播放完毕时会自动调用。
**使用步骤:**
1. 确保控件对象已经创建且初始状态为不可见或透明度为0(可以通过 `GUI:setOpacity(widget, 0)` 设置)。
2. 调用 `GUI:Timeline_FadeIn` 并传入控件对象、时间和可选的完成回调。
**代码示例:**
```lua
-- 1. 创建一个父窗口
local parent = GUI:Win_Create("MyWindow", 0, 0, 0, 0, false, false, true, false, false, false, 1)
-- 2. 创建一个图片控件,并初始设置为完全透明(可选)
local image = GUI:Image_Create(parent, "my_image", 100, 100, "res/public/1900000610.png")
GUI:setOpacity(image, 0) -- 设置初始透明度为0(完全透明)
-- 3. 播放淡入动画,持续2秒,动画完成后打印信息
GUI:Timeline_FadeIn(image, 2.0, function()
SL:Print("图片淡入动画播放完成!")
end)
```
**注意事项:**
- 这个函数会让控件从完全透明(或当前透明度)渐变到完全不透明(255)。
- 如果控件原本就是可见的,动画效果可能不明显。
- `timelineCB` 参数是可选的,不传递则没有完成回调。
- 可以与其他 `Timeline_` 系列函数组合使用,创建更复杂的动画序列。
这个函数常用于界面元素的优雅显示,比如新消息提示、角色出场等场景。
← 返回问答库