dwMessage:[輸入參數] 說明要執行的動作。動作的可選值如下:
NIM_ADD 增加壹個圖標到托盤區
NIM_DELETE 從托盤區刪除壹個圖標
NIM_MODIFY 修改圖標
NIM_SETFOCUS 將焦點(Focus)返回托盤區。這個消息通常在托盤區圖標完成了用戶界面下的操作後發出。比如壹個托盤圖標顯示了壹個快捷菜單,然後用戶按下ESC鍵了操作,這時使用NIM_SETFOCUS將焦點繼續保留在托盤區。該項僅在系統外殼與常用控制DLL( Shlwapi.dll與Comctl32.dll)5.0以上版本才可用。
NIM_SETVERSION 指定使用特定版本的系統外殼與常用控制DLL。缺省值為0,表示使用Win95方式。該項僅在系統外殼與常用控制DLL 5.0以上版本才可用。
lpdata:[輸入參數] 壹個指向NOTIFYICONDATA結構的指針。
返回值:成功時函數返回TRUE,否則FALSE。
NOTIFYICONDATA 結構的說明(最新版)如下:
typedef struct _NOTIFYICONDATA {
DWORD cbSize;
HWND hWnd;
UINT uID;
UINT uFlags;
UINT uCallbackMessage;
HICON hIcon;
TCHAR szTip[64];
DWORD dwState;
DWORD dwStateMask;
TCHAR szInfo[256];
union {
UINT uTimeout;
UINT uVersion;
};
TCHAR szInfoTitle[64];
DWORD dwInfoFlags;
GUID guidItem;
} NOTIFYICONDATA, *PNOTIFYICONDATA;
cbSize 以字節計的結構大小,以適應不同版本。
hWnd 接收Windows消息的窗口句柄。
uID 托盤圖標的ID。
uFlags 指示結構中的哪些成員包含有效數據,可選值:NIF_ICON, NIF_MESSAGE,NIF_TIP,NIF_STATE,NIF_INFO,NIF_GUID。
uCallbackMessage 回調消息ID,由用戶自定義。與壹個自定義的消息處理函數關聯。
hIcon 托盤圖標的句柄。
szTip 托盤圖標的提示字符串。
註意:以下數據成員僅限系統外殼與常用控制DLL 5.0及以上版本才有效!
dwState 圖標的狀態:NIS_HIDDEN-隱藏,或NIS_SHAREDICON-可視。
dwStateMask 圖標狀態掩碼,用以設置dwState
szInfo 氣球型提示(Balloon ToolTip)的字符串。
uTimeout 以毫秒計的提示顯示時間
uVersion 確定所依賴的版本。0-Win95,NOTIFYICON_VERSION-Win2000
szInfoTitle 氣球型提示的標題
dwInfoFlags 設置氣球型提示所用的圖標(類似MessageBox中所使用的圖標):
NIIF_ERROR 錯誤
NIIF_INFO 信息
NIIF_NONE 沒有圖標
NIIF_WARNING 警告
NIIF_ICON_MASK 6.0版本保留
NIIF_NOSOUND 限6.0版本,不播放對應的聲音