YStudio Y++

加载层 / 加载动画(基础支持库)

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

路径:支持库 → 基础支持库 → 加载层。

硬约束

  1. 扁平命令;在窗口上显示等待遮罩与动画(类似 Web Loading)。
  2. 分类名在面板中为「加载层」。
  3. 加载动画默认约 3 秒自动关闭;长任务请设 时长=0,结束后调用 关闭加载动画。
  4. 再次调用 加载动画 会刷新样式与倒计时。
  5. 与 DLL 动态装载无关——第三方 DLL 见 dllapi。

快速开始

加载动画("正在保存…", 9, 0)
// …耗时操作…
关闭加载动画()
提示框("完成")

加载层

本分类共 2 条。

加载动画

  • 签名:无 加载动画([文本 提示="加载中..."], [整数 样式=1], [整数 时长=3000], [整数 遮罩透明度=60], [整数 文本对齐=2], [文本 背景色=""])
  • 说明:显示全窗体等待遮罩与精美加载动画;标题栏仍可拖动窗口。
  • 参数一│[文本 提示=”加载中…”]: 遮罩中央提示文字;省略或空文本则用默认
  • 参数二│[整数 样式=1]: 内置样式 1~48: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=DNA螺旋 29=花瓣 30=风车 31=九宫格脉冲 32=涟漪 33=双涟漪 34=心跳圆 35=呼吸灯 36=旋涡 37=流星 38=拼图 39=三线跳动 40=电池充电 41=进度弧 42=星形 43=六角形 44=齿轮 45=原子轨道 46=波浪圆 47=弹跳球 48=彩虹弧
  • 参数三│[整数 时长=3000]: 自动关闭时长(毫秒):省略时默认3000;0=不自动关闭
  • 参数四│[整数 遮罩透明度=60]: 遮罩暗度 0~100;省略时默认60
  • 参数五│[整数 文本对齐=2]: 1=左对齐 2=居中 3=右对齐
  • 参数六│[文本 背景色=”“]: 中央卡片背景色,#RGB 或 #ARGB;省略或空为透明(仅黑色遮罩)

关闭加载动画

  • 签名:无 关闭加载动画()
  • 说明:立即关闭当前加载遮罩。

易错对照

错误 正确
时长默认当一直显示 默认约 3000ms 自动关;常驻请 时长=0
忘记关闭遮罩 长任务结束必须 关闭加载动画
与 DLL_加载 混淆 本页只是 UI 等待层

相关

对话框 · DLL 支持库 · 进程