托盘类（扩展类库）

本稿为扩展类库 API，不是 YSS 选择器。 无 tray { … }；系统托盘图标由类方法控制。

非可视化。声明：托盘类 t；亦可用 创建托盘()。

硬约束

1. 需要主窗口已创建后再 显示（推荐写在 主窗口.创建完毕）。
2. 方法调用带括号；单击/双击/右键/气泡 挂接无参*回调。
3. 显示/隐藏/置*/显示气泡 等返回整数：1 成功 · 0 失败。
4. 退出前建议 销毁()。关窗不退出：在 即将关闭 里隐藏窗口并 关闭(假)。
5. 托盘右键菜单：用 右键菜单类 的 系统显示()，不要用窗内 显示()。
6. 任务栏/explorer 重启后图标会自动重挂。

---

快速开始（常驻托盘）

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

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

更完整的热键组合见 托盘+热键最小例。

---

常量

项	取值
气泡图标种类	0无 · 1信息 · 2警告 · 3错误

---

方法签名

方法	签名	返回	说明
显示	整数 t.显示([文本 提示])	整数	加入托盘
隐藏	整数 t.隐藏()	整数	移除图标
置提示	整数 t.置提示(文本 提示)	整数	悬停 tip
置图标	整数 t.置图标(文本 路径)	整数	.ico/.png/:/ 等
显示气泡	整数 t.显示气泡(文本 标题, 文本 文本, [整数 毫秒=3000], [整数 图标种类=1])	整数
单击	整数 t.单击(子程序指针 回调)	整数	左键单击
双击	整数 t.双击(子程序指针 回调)	整数	左键双击
右键	整数 t.右键(子程序指针 回调)	整数	常配合菜单 系统显示
气泡单击	整数 t.气泡单击(子程序指针 回调)	整数	用户点击气泡
气泡关闭	整数 t.气泡关闭(子程序指针 回调)	整数	超时/系统隐藏
销毁	整数 t.销毁()	整数	隐藏并释放

---

事件（回调）

注册	回调签名	说明
单击(&fn)	函数 fn()	左键单击
双击(&fn)	函数 fn()	左键双击
右键(&fn)	函数 fn()	右键 → 建议 菜单.系统显示()
气泡单击(&fn)	函数 fn()	用户点击气泡
气泡关闭(&fn)	函数 fn()	气泡超时或被系统关掉

---

与消息条 / 通知

	托盘	消息条	通知类
形态	任务栏图标	窗内横条	浮动 Toast
文档	本页	messagebar	界面支持库通知命令
YSS	无	无	无