YStudio Y++

动画类

Y++ / YStudio 开发文档 · 一点滴

类对象支持库（不是扁平命令）。路径：支持库 → 扩展类库 → 动画类。

类型名必须写完整「动画类」。声明时自动创建，一般无需再调 创建*。

硬约束

  1. 类型名必须写「动画类」。
  2. 建议先置组件，再移动/缩放/淡入淡出；调用即播。
  3. 方法调用必须带括号。

快速开始

动画类 ani
ani.置组件(按钮1.句柄)
ani.移动到(100, 80, 300)

动画类/创建

共 1 条。

创建动画

  • 签名：通用 创建动画()
  • 说明：显式创建一个动画对象（一般直接写「动画类 ani」即可，声明时自动创建）。

动画类/方法

共 14 条。

置组件

  • 签名：无 置组件(长整数 句柄)
  • 说明：绑定动画作用目标。句柄取自组件「.句柄」（逻辑 ID，1 起）或主窗口「.句柄」（HWND）。
  • 参数一│长整数 句柄: 如 按钮1.句柄；传 0 清除绑定。

置动画

  • 签名：无 置动画([整数 类型=1], [整数 毫秒=500], [整数 强度=20])
  • 说明：设置 ani.动画() 的默认类型/时长/强度；本身不立即播放。
  • 参数一│[整数 类型=1]: 特效类型 1~40。
  • 参数二│[整数 毫秒=500]: 默认时长。
  • 参数三│[整数 强度=20]: 默认强度/幅度（像素级）。

停止

  • 签名：逻辑 停止([长整数 句柄])
  • 说明：停止进行中的动画；省略句柄时作用于置组件() 绑定目标。
  • 参数一│[长整数 句柄]: 可选；省略则用置组件() 目标。

动画

  • 签名：逻辑 动画([整数 类型], [整数 毫秒], [整数 强度])
  • 说明：按类型立即播放一次特效；省略参数时使用 置动画() 默认值。 类型：1左右抖动 2上下抖动 3缩放 4弹入淡入 5脉冲 6闪烁 7滑入 8弹跳 9环绕 10摆动 11旋转 12呼吸 13翻转 14果冻 15橡皮 16心跳 17摇晃 18发光 19甩入 20翻牌 21震动 22弹入 23缩小消失 24霓虹 25闪缩 26旋入 27上浮 28掉落 29弹性缩放 30波浪摆动 31摇摆缩放 32螺旋进入 33频闪 34翻转进入 35滚入 36铰链 37抛物线 38扫光 39庆祝 40橡皮弹入。
  • 参数一│[整数 类型]: 1~40；默认取 置动画。
  • 参数二│[整数 毫秒]: 可选。
  • 参数三│[整数 强度]: 可选。

移动到

  • 签名：无 移动到(整数 X, 整数 Y, [整数 毫秒], [整数 类型], [整数 强度])
  • 说明：将目标从当前位置过渡到 (X,Y)；宽高不变。主窗口也可移动。
  • 参数一│整数 X: 目标左边。
  • 参数二│整数 Y: 目标顶边。
  • 参数三│[整数 毫秒]: 时长；省略用 置动画 默认。
  • 参数四│[整数 类型=0]: 可选，当前请传 0。
  • 参数五│[整数 强度=0]: 可选，当前请传 0。

调整大小

  • 签名：无 调整大小(整数 宽, 整数 高, [整数 毫秒])
  • 说明：将目标宽高过渡到指定值；左边/顶边不变。主窗口也可调整。
  • 参数一│整数 宽: 目标宽度。
  • 参数二│整数 高: 目标高度。
  • 参数三│[整数 毫秒]: 时长；省略用默认。

淡入

  • 签名：无 淡入([整数 毫秒])
  • 说明：目标控件透明度从当前（或 0）过渡到不透明；会先置为可见。不支持主窗口。
  • 参数一│[整数 毫秒]: 时长；省略用默认。

淡出

  • 签名：无 淡出([整数 毫秒])
  • 说明：目标控件淡出至全透明，结束后隐藏。不支持主窗口。
  • 参数一│[整数 毫秒]: 时长；省略用默认。

淡入淡出

  • 签名：逻辑 淡入淡出([整数 毫秒])
  • 说明：先淡入再淡出（总时长约 2×毫秒），适合提示性闪烁。
  • 参数一│[整数 毫秒]: 单程时长；默认 400。

置透明度

  • 签名：逻辑 置透明度(整数 透明度)
  • 说明：立即设置透明度（0~255，255=不透明），不播放过渡。
  • 参数一│整数 透明度: 0=全透明，255=不透明。

移相对

  • 签名：无 移相对(整数 X偏移, 整数 Y偏移, [整数 毫秒], [整数 类型], [整数 强度])
  • 说明：相对当前位置移动；正 X 向右、正 Y 向下。
  • 参数一│整数 X偏移: 水平像素。
  • 参数二│整数 Y偏移: 垂直像素。
  • 参数三│[整数 毫秒]: 默认 300。
  • 参数四│[整数 类型=0]: 可选，当前请传 0。
  • 参数五│[整数 强度=0]: 可选，当前请传 0。

显示

  • 签名：逻辑 显示([长整数 句柄])
  • 说明：立即显示目标（不播放动画）。
  • 参数一│[长整数 句柄]: 可选；省略用置组件目标。

隐藏

  • 签名：逻辑 隐藏([长整数 句柄])
  • 说明：立即隐藏目标（不播放动画）。
  • 参数一│[长整数 句柄]: 可选；省略用置组件目标。

%1([整数 毫秒], [整数 强度]) / %1(长整数 句柄, [整数 毫秒], [整数 强度])

  • 签名：逻辑 播放「%1」特效（类型 %2）。三参数时第一参为组件句柄。
  • 说明：参数│毫秒/强度；或 句柄, 毫秒, 强度。

易错对照

错误 正确
类型写成「动画」 必须「动画类」
未置组件就播 先置组件(句柄)

相关

提示层类 · 窗口操作