YStudio Y++

通知类

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

类对象支持库(不是扁平命令)。路径:支持库 → 扩展类库 → 通知类。

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

硬约束

  1. 类型名必须写「通知类」(若面板为通知类命令,按签名调用)。
  2. 系统/窗内通知展示;位置与时长以方法为准。

快速开始

通知类 n
n.显示(1, "已保存")

通知类

共 9 条。

成功通知

  • 签名:无 成功通知(内容, 标题, 位置, 时长, 最大宽度, 动画)
  • 说明:显示 Web 风格成功 Toast,非阻塞;点击可提前关闭。

错误通知

  • 签名:无 错误通知(文本 内容, [文本 标题=""], [整数 位置=0], [整数 时长=-1], [整数 最大宽度=0], [整数 动画=-1])
  • 说明:显示 Web 风格错误 Toast,非阻塞;省略时长时默认 5000 毫秒自动关闭。

警告通知

  • 签名:无 警告通知(文本 内容, [文本 标题=""], [整数 位置=0], [整数 时长=-1], [整数 最大宽度=0], [整数 动画=-1])
  • 说明:显示 Web 风格警告 Toast,非阻塞;省略时长时默认 4500 毫秒自动关闭。

通知

  • 签名:无 通知(整数 类型, 文本 内容, [文本 标题=""], [整数 位置=0], [整数 时长=-1], [整数 最大宽度=0], [整数 动画=-1])
  • 说明:按类型显示 Toast:1=成功 2=错误 3=警告;其余参数同「成功通知」。
  • 参数一│整数 类型: 1=成功(默认3000毫秒) 2=错误(默认5000毫秒) 3=警告(默认4500毫秒)
  • 参数二│文本 内容: 通知正文(必填)
  • 参数三│[文本 标题=”“]: 可选;加粗显示在正文上方,省略或空文本则不显示标题
  • 参数四│[整数 位置=0]: %1
  • 参数五│[整数 时长=-1]: 自动关闭时长(毫秒):省略或-1时使用上列类型对应默认毫秒数;0=不自动关闭;>0=指定毫秒数
  • 参数六│[整数 最大宽度=0]: 卡片最大宽度(像素):省略或0时默认360;>0=指定像素
  • 参数七│[整数 动画=-1]: %1

置通知位置

  • 签名:无 置通知位置(整数 位置)
  • 说明:设置后续通知的默认显示位置(当单次调用位置参数为 0 或未传时生效)。
  • 参数一│整数 位置: 1=左上角;2=上边缘居中;3=右上角;4=左边缘居中;5=窗口正中央;6=右边缘居中;7=左下角;8=下边缘居中;9=右下角(内置默认2)

置通知时长

  • 签名:无 置通知时长(整数 毫秒)
  • 说明:设置后续通知的统一自动关闭时长(毫秒);-1 恢复各命令内置默认。
  • 参数一│整数 毫秒: -1=恢复内置默认(成功3000/警告4500/错误5000);0=不自动关闭;>0=统一使用该毫秒数

置通知最大宽度

  • 签名:无 置通知最大宽度(整数 像素)
  • 说明:设置后续通知卡片的默认最大宽度(像素)。
  • 参数一│整数 像素: 省略或0=恢复默认360像素;>0=指定最大宽度(像素)

置通知动画

  • 签名:无 置通知动画(整数 动画)
  • 说明:设置后续通知的默认进入/退出动画。
  • 参数一│整数 动画: 0=滑入淡出(内置默认);1=纯淡入淡出;2=缩放弹入

关闭全部通知

  • 签名:无 关闭全部通知()
  • 说明:立即关闭当前窗口上所有进行中的 Toast 通知。

易错对照

错误 正确
类型名写错 以面板「通知类」为准

相关

消息条 · 托盘类