类对象支持库(不是扁平命令)。路径:支持库 → 扩展类库 → 托盘类。
类型名必须写完整「托盘类」。声明时自动创建,一般无需再调 创建*。
硬约束
- 类型名必须写「托盘类」。
- 须在「主窗口.创建完毕」后再
显示;退出前应销毁。 - 关窗藏托盘:
即将关闭里隐藏主窗口并关闭(假)。 - 右键菜单用「右键菜单类」的
系统显示()(见相关链接)。
快速开始
托盘类 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错误
单击
- 签名:
整数 单击(子程序指针 回调) - 说明:注册托盘左键单击回调(无参)。
- 参数一│子程序指针 回调: 如 &托盘单击
双击
- 签名:
整数 双击(子程序指针 回调) - 说明:注册托盘左键双击回调(无参)。
- 参数一│子程序指针 回调
右键
- 签名:
整数 右键(子程序指针 回调) - 说明:注册托盘右键回调(无参)。回调里用「右键菜单类.系统显示()」弹出托盘旁菜单。
- 参数一│子程序指针 回调
气泡单击
- 签名:
整数 气泡单击(子程序指针 回调) - 说明:注册气泡被用户点击时的回调(无参)。
- 参数一│子程序指针 回调: 如 &气泡被点
气泡关闭
- 签名:
整数 气泡关闭(子程序指针 回调) - 说明:注册气泡因超时或系统隐藏而关闭时的回调(无参)。
- 参数一│子程序指针 回调
销毁
- 签名:
整数 销毁() - 说明:隐藏并释放托盘对象。
- 参数│无(仍须写括号)
易错对照
| 错误 | 正确 |
|---|---|
| 类型写成「托盘」 | 必须「托盘类」 |
| 创建前就 显示 | 放到 主窗口.创建完毕 |
| 右键用菜单.显示() | 托盘旁须 系统显示() |
| 退出不销毁 | 真正退出前 销毁() |