YStudio Y++

托盘类

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

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

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

硬约束

  1. 类型名必须写「托盘类」。
  2. 须在「主窗口.创建完毕」后再 显示;退出前应 销毁。
  3. 关窗藏托盘:即将关闭 里隐藏主窗口并 关闭(假)。
  4. 右键菜单用「右键菜单类」的 系统显示()(见相关链接)。

快速开始

托盘类 g_托盘
右键菜单类 g_菜单
逻辑 g_强制退出 = 假

函数 托盘单击() {
    主窗口.显示()
    激活窗口()
}
函数 托盘右键() {
    g_菜单.系统显示()
}
函数 主窗口.创建完毕() {
    g_菜单.添加项("显示")
    g_菜单.添加项("退出")
    g_托盘.单击(&托盘单击)
    g_托盘.右键(&托盘右键)
    g_托盘.置图标("资源\\app.png")  // 亦可用.ico 或 :/ 资源
    g_托盘.显示("后台运行中")
}
函数 主窗口.即将关闭() {
    如果 (g_强制退出 == 假) {
        主窗口.隐藏()
        关闭(假)
        返回 ()
    }
    g_托盘.销毁()
}

托盘类/创建

共 1 条。

创建托盘

  • 签名:通用 创建托盘()
  • 说明:创建系统托盘对象。一般直接写「托盘类 t」即可(声明时自动创建)。

托盘类/方法

共 11 条。

显示

  • 签名:整数 显示([文本 提示])
  • 说明:在系统托盘显示图标;可选设置悬停提示。
  • 参数一│[文本 提示]: 托盘悬停提示,可省略

隐藏

  • 签名:整数 隐藏()
  • 说明:从系统托盘移除图标。
  • 参数│无(仍须写括号)

置提示

  • 签名:整数 置提示(文本 提示)
  • 说明:设置托盘悬停提示。
  • 参数一│文本 提示: 悬停文案

置图标

  • 签名:整数 置图标(文本 路径)
  • 说明:设置托盘图标:支持.ico/.png/.bmp 等文件,以及 :/ 嵌入资源路径。
  • 参数一│文本 路径: 如 “资源\app.png”、”app.ico”、”:/tray.png”

显示气泡

  • 签名:整数 显示气泡(文本 标题, 文本 文本, [整数 毫秒], [整数 图标种类])
  • 说明:弹出托盘气泡通知;可用 气泡单击 / 气泡关闭 接收交互。
  • 参数一│文本 标题
  • 参数二│文本 文本
  • 参数三│[整数 毫秒]: 默认 3000
  • 参数四│[整数 图标种类]: 0无 1信息 2警告 3错误

单击

  • 签名:整数 单击(子程序指针 回调)
  • 说明:注册托盘左键单击回调(无参)。
  • 参数一│子程序指针 回调: 如 &托盘单击

双击

  • 签名:整数 双击(子程序指针 回调)
  • 说明:注册托盘左键双击回调(无参)。
  • 参数一│子程序指针 回调

右键

  • 签名:整数 右键(子程序指针 回调)
  • 说明:注册托盘右键回调(无参)。回调里用「右键菜单类.系统显示()」弹出托盘旁菜单。
  • 参数一│子程序指针 回调

气泡单击

  • 签名:整数 气泡单击(子程序指针 回调)
  • 说明:注册气泡被用户点击时的回调(无参)。
  • 参数一│子程序指针 回调: 如 &气泡被点

气泡关闭

  • 签名:整数 气泡关闭(子程序指针 回调)
  • 说明:注册气泡因超时或系统隐藏而关闭时的回调(无参)。
  • 参数一│子程序指针 回调

销毁

  • 签名:整数 销毁()
  • 说明:隐藏并释放托盘对象。
  • 参数│无(仍须写括号)

易错对照

错误 正确
类型写成「托盘」 必须「托盘类」
创建前就 显示 放到 主窗口.创建完毕
右键用菜单.显示() 托盘旁须 系统显示()
退出不销毁 真正退出前 销毁()

相关

右键菜单类 · 通知类 · 托盘+热键例 · YSS tray