# win.util.tray 库模块帮助文档

## win.util 成员列表 <a id="win.util" href="#win.util">&#x23;</a>

### win.util.tray <a id="win.util.tray" href="#win.util.tray">&#x23;</a>
创建托盘图标

### win.util.tray() <a id="win.util.tray" href="#win.util.tray">&#x23;</a>
[返回对象:winUtilTrayObject](#winUtilTrayObject)

### win.util.tray(主窗体,图标,提示信息) <a id="win.util.tray" href="#win.util.tray">&#x23;</a>
创建托盘图标,必须指定窗体对象。  
图标参数可指定图标ID、句柄、图标数据或图标路径，默认为窗体图标。  
提示信息：鼠标移到托盘图标上提示的信息,省略则没有提示信息

## winUtilTrayObject 成员列表 <a id="winUtilTrayObject" href="#winUtilTrayObject">&#x23;</a>

### winUtilTrayObject.delete() <a id="winUtilTrayObject.delete" href="#winUtilTrayObject.delete">&#x23;</a>
删除托盘图标。  
如果指定了图标数据或路径则必须在不需要托盘图标时调用delete函数释放

### winUtilTrayObject.icon <a id="winUtilTrayObject.icon" href="#winUtilTrayObject.icon">&#x23;</a>
用于设置托盘图标,只写属性。  
属性值可以是图标ID、句柄、图标数据或图标路径,  
32位图标,最好同时提供 16x16、32x32 的复合图标  

如果传入的是需要释放的图标句柄请改用 setIcon 函数

### winUtilTrayObject.message <a id="winUtilTrayObject.message" href="#winUtilTrayObject.message">&#x23;</a>
指定回调消息  
当用户点击托盘图标时、向主窗体发送此消息

### winUtilTrayObject.pop <a id="winUtilTrayObject.pop" href="#winUtilTrayObject.pop">&#x23;</a>
发送托盘消息通知。  
Win10 以下显示为汽泡提示，  
Win10 开始由操作系统的『专注』、应用程序的『通知』等设置决定是否显示模幅提示或折叠消息到通知区。  
Win10/11 获取通知消息可使用 dotNet.toastListener 扩展库。

### winUtilTrayObject.pop(提示信息,标题,图标ID,显示超时) <a id="winUtilTrayObject.pop" href="#winUtilTrayObject.pop">&#x23;</a>
发送托盘消息通知。  
图标 ID 可省略，警告图标设为2,错误图标设为3  
显示超时以秒为单位

### winUtilTrayObject.reset() <a id="winUtilTrayObject.reset" href="#winUtilTrayObject.reset">&#x23;</a>
重置并恢复托盘图标

### winUtilTrayObject.setIcon() <a id="winUtilTrayObject.setIcon" href="#winUtilTrayObject.setIcon">&#x23;</a>
设置托盘的图标,  
参数@1可以是图标ID、句柄、图标数据或图标路径,  
32位图标,最好同时提供 16x16、32x32 的复合图标  

如果指定需要释放的图标句柄，参数@2 应设为 true

### winUtilTrayObject.tip <a id="winUtilTrayObject.tip" href="#winUtilTrayObject.tip">&#x23;</a>
设置鼠标提示信息

### 自动完成常量
_NIIF_ERROR=3  
_NIIF_ICON_MASK=0xF  
_NIIF_INFO=1  
_NIIF_NOSOUND=0x10  
_NIIF_WARNING=2  
