一个托盘程序演示 －闹钟 Alert（转载）

 想必大家都看见过那些在系统托盘（Tray）中的程序吧，本文就演示了如何创建一个这样的托盘程序Alert。Alert是一个运行在系统托盘中的小闹钟，它在设定的时间后触发，运行屏幕保护程序并播放一首歌曲。这个程序是很久以前写的了，而我现在没有安装VC++了，所以本文的截图都是朋友Leoyin帮我做出来后传给我的（好麻烦，呵呵），在此也对他表示感谢！
　　建立一个托盘程序的关键在于Windows API－Shell_NotifyIcon()的使用，这个API的声明包含在ShellAPI.H文件中。请在StdAfx.h中使用“#include <ShellAPI.H>”将其引入工程，别象我当时那么傻－在工程管理器里引入了该文件，导致现在你们在类视图中看见了许多不希望看到的东西。我现在也没有VC++ IDE来修改它了，就这样吧。
　　首先，给大家介绍一下相关的函数和结构：Shell_NotifyIcon()的原型和说明（最新版）如下：

BOOL Shell_NotifyIcon(
	DWORD dwMessage,
	PNOTIFYICONDATA lpdata
	);

参数及返回值说明：
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版本，不播放对应的声音
guidItem	6.0版本保留

接下来，让我们开始实现这个Alert吧。Alert是一个基于对话框的Win32应用程序，利用AppWizard 创建它吧。然后设计一下这个对话框如图：



在AlertDlg.H中加入：

#include < mmsystem.h >          //这个头文件是干什么的记不得了，呵呵

#define WM_NOTIFYICON	WM_USER+5  //自定义消息的ID
#define IDI_ICON		0x0005     //图标ID
#define IDT_APPLY		WM_USER+6  //我要使用的定时器Timer的自定义消息ID

　　然后为类CAlertDlg添加数据成员m_Interval和自定义成员函数的声明（怎么添加不用我教了吧？）。最后形成CAlertDlg类的声明（已去掉了一些注释）如下：

class CAlertDlg : public CDialog
{
public:
	~CAlertDlg();
	CAlertDlg(CWnd* pParent = NULL);


	enum { IDD = IDD_ALERT_DIALOG };
	int	m_Interval;		//定时间隔，以分钟为单位


protected:
	virtual void DoDataExchange(CDataExchange* pDX);


protected:
	void ShowMessage(void);  //自定义的定时触发时运行的函数
	HICON m_hIcon;  //图标句柄


	virtual BOOL OnInitDialog();
	afx_msg void OnPaint();
	afx_msg HCURSOR OnQueryDragIcon();


	afx_msg void OnClickApply();  //"应用"按钮的点击消息处理函数
	virtual void OnCancel();  //"退出"按钮的点击消息处理函数
	afx_msg void OnTimer(UINT nIDEvent);  //定时器消息处理函数
	afx_msg void OnClickHide();  //"隐藏"按钮的点击消息处理函数

	//自定义WM_NOTIFYICON消息的处理函数
	afx_msg void OnNotifyIcon(WPARAM wParam, LPARAM lParam);  
	afx_msg void OnSysCommand(UINT nID, LPARAM lParam);  //系统消息处理函数
	afx_msg BOOL OnQueryEndSession();  //Windows关闭消息处理函数


	DECLARE_MESSAGE_MAP()
};

以下是AlertDlg.CPP中相应函数的实现（还是设置点锚点吧）：

BOOL CAlertDlg::OnInitDialog()
{
	SetIcon(m_hIcon, TRUE);
	SetIcon(m_hIcon, FALSE);
	
	// 初始化时间间隔
	CSpinButtonCtrl * pSpin;
	pSpin = (CSpinButtonCtrl *) GetDlgItem(IDC_SPIN);
	pSpin->SetRange(5,150);
	m_Interval = 30;
	CDialog::OnInitDialog();
	
	// 设置定时器，每秒一次心跳
	SetTimer(1, 1000, NULL);

	// 将图标放入系统托盘
	NOTIFYICONDATA nd;
	nd.cbSize	= sizeof (NOTIFYICONDATA);
	nd.hWnd	= m_hWnd;
	nd.uID	= IDI_ICON;
	nd.uFlags	= NIF_ICON|NIF_MESSAGE|NIF_TIP;
	nd.uCallbackMessage= WM_NOTIFYICON;
	nd.hIcon	= m_hIcon;

	strcpy(nd.szTip, "我的闹钟");
	
	Shell_NotifyIcon(NIM_ADD, &nd);
	
	return TRUE;
}
void CAlertDlg::OnClickApply() 
{
	// 重置时间间隔
	UpdateData();
	OnTimer(IDT_APPLY);
}
void CAlertDlg::OnCancel() 
{
	// 释放定时器
	KillTimer(1);

	// 将图标从系统托盘中删除
	NOTIFYICONDATA nd;
	nd.cbSize	= sizeof (NOTIFYICONDATA);
	nd.hWnd	= m_hWnd;
	Shell_NotifyIcon(NIM_DELETE, &nd);
	
	CDialog::OnCancel();
}
void CAlertDlg::OnTimer(UINT nIDEvent) 
{
	static CString	strTemp;
	static int		Count = 0;
	COleDateTime	dtTime;

	// 刷新显示的时间
	//常在论坛里遇到人问怎么获得当前时间，这相知道了吧？
	dtTime = COleDateTime::GetCurrentTime();  
	strTemp.Format("现在时间 %02i:%02i:%02i ",
			dtTime.GetHour(),
			dtTime.GetMinute(),
			dtTime.GetSecond());
	GetDlgItem(IDC_CURTIME)->SetWindowText(strTemp);

	// 刷新剩余时间值
	if (nIDEvent == IDT_APPLY) Count = 0;  //若用户重新定义了时间间隔，则重新开始计时
	Count++;
	int RestTime;
	RestTime = m_Interval - Count/60;
	if (RestTime <= 0) 
	{
		Count = 0;
		ShowMessage();
	}
	
	strTemp.Format("离下次提醒还差 %i 分钟", RestTime);
	GetDlgItem(IDC_RESTTIME)->SetWindowText(strTemp);	
	CDialog::OnTimer(nIDEvent);
}

//这个 ShowMessasge()函数，你们需要自己修改一下，我的代码太死板了

void CAlertDlg::ShowMessage()
{
	//调用C:/InfoCD/WinaMP/下的WinaMP3播放Music.m3u清单
	::WinExec("C://INFOCD//WINAMP//WINAMP.EXE music.m3u",SW_HIDE);
	
	MessageBox("您该休息一会儿了......", 
			"休息", 
			MB_SYSTEMMODAL|MB_OK|MB_ICONEXCLAMATION|MB_ICONWARNING);

	//运行C:/Windows/System下的太空屏保
	ShellExecute(m_hWnd,"open","C://WINDOWS//SYSTEM//太空.scr", NULL,NULL,SW_SHOWNORMAL);
}
afx_msg void CAlertDlg::OnNotifyIcon(WPARAM wParam, LPARAM lParam)
{
	// 响应在托盘图标上的单击
	//wParam中是响应消息的图标ID，lParam中则是Windows的消息
	if ((wParam == IDI_ICON)&&(lParam == WM_LBUTTONDOWN))
		ShowWindow(SW_SHOWNORMAL);
}
void CAlertDlg::OnSysCommand(UINT nID, LPARAM lParam)
{
	// 屏蔽最大化(MFC Bug？)，将最小化重定向至隐藏窗口
	if (nID == SC_MAXIMIZE)
		return;
	if (nID == SC_MINIMIZE)
		ShowWindow(SW_HIDE);
	else
		CWnd::OnSysCommand(nID, lParam);
}
BOOL CAlertDlg::OnQueryEndSession()
{
	// 在用户退出Windows时自动退出应用程序
	CAlertDlg::OnCancel();
	return TRUE;
}

void CAlertDlg::OnClickHide() 
{
	OnSysCommand(SC_MINIMIZE, 0x0000);
	return;
}

　　好了，通过阅读上面这些源代码，我想大家对托盘程序的创建有了一定的认识了吧，这也是本文的根本目的。 只是这个程序有个Bug：在程序退出后图标仍在托盘区显示，要把鼠标在图标上面过一下才会消失。这个Bug记得有人提出过解决办法，好象是要释放图标句柄什么的。可惜我记不得了，这个程序也没有再修改。

衷心希望大家给我回复，谢谢！

参考文章：
1、MSDN中的相关链接： The Taskbar， TrayNot Sample，
2、VCKBase里也有不少优秀文章（比如NorthTibet编译的“ 系统托盘编程完全指南”）。

在硬盘版的MSDN还会有相应的专题文章，自己搜搜吧。