本稿为界面支持库 API,不是 YSS 选择器。 无设计器组件 /
messagebar { … };外观由「样式」整数与置消息条颜色等命令控制。
路径:界面支持库 → 消息条。在当前窗口叠加顶/底横条;与浮动 Toast(成功通知)分工不同。
硬约束
- 扁平命令:直接
显示消息条(...),无对象前缀、无控件事件。 - 时长:
-1→默认约 3000 ms;0=常驻。 - 位置/样式传
-1表示保持当前默认。 - 旧工程 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 用通知命令;横条用本页 |