YStudio Y++

消息条(扁平支持库)

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

本稿为界面支持库 API,不是 YSS 选择器。 无设计器组件 / messagebar { … };外观由「样式」整数与 置消息条颜色 等命令控制。

路径:界面支持库 → 消息条。在当前窗口叠加顶/底横条;与浮动 Toast(成功通知)分工不同。

硬约束

  1. 扁平命令:直接 显示消息条(...),无对象前缀、无控件事件。
  2. 时长:-1→默认约 3000 ms;0=常驻。
  3. 位置/样式传 -1 表示保持当前默认。
  4. 旧工程 XML 若有 <消息条>:可反序列化,但不再作可视化组件维护。

常量

项 取值
级别 0信息 · 1成功 · 2警告 · 3错误
位置 0顶 · 1底;-1=保持默认
样式 0强调条 · 1填充 · 2描边 · 3浮动 · 4细线 · 5胶囊 · 6玻璃 · 7渐变;-1=保持

命令

本分类共 7 条。

成功级别消息条。

  • 签名:无 参数一│文本 内容
  • 说明:参数二│[整数 时长=-1]
  • 参数三│[整数 位置=-1]
  • 参数四│[整数 样式=-1]

错误级别消息条。

  • 签名:无 参数一│文本 内容
  • 说明:参数二│[整数 时长=-1]
  • 参数三│[整数 位置=-1]
  • 参数四│[整数 样式=-1]

警告级别消息条。

  • 签名:无 参数一│文本 内容
  • 说明:参数二│[整数 时长=-1]
  • 参数三│[整数 位置=-1]
  • 参数四│[整数 样式=-1]

信息级别消息条。

  • 签名:无 参数一│文本 内容
  • 说明:参数二│[整数 时长=-1]
  • 参数三│[整数 位置=-1]
  • 参数四│[整数 样式=-1]

隐藏当前窗口上的消息条。

  • 签名:无 参数│无(仍须写括号)
  • 说明:隐藏消息条()

返回当前窗口消息条是否正在显示。

  • 签名:逻辑 参数│无(仍须写括号)
  • 说明:取消息条可见()

返回当前消息条级别(0~3)。

  • 签名:整数 参数│无(仍须写括号)
  • 说明:取消息条级别()

易错对照

错误 正确
当控件对象调方法 直接写扁平命令
时长 0 当瞬时 0=常驻;默认用 -1
与成功通知混用 Toast 用通知命令;横条用本页

相关

提示层类 · 托盘类 · 界面支持库