用C++ Builder编写Tray程序
周新栋
Tray(托盘)是Windows9x任务条上的一个特殊区域，它的技术名称为“任务栏布告区”，一些软件(如金山词霸Ⅲ)运行时会在托盘上放置一个图标，使用户一眼就能知道这个程序正在后台运行，要想激活它也很容易，通常只需单击一下这个图标即可，非常方便。 Tray的编程比较特殊，但并不难，主要包括图标、工具提示和消息等三个方面，它是Shell编程的一部分。ShellAPI提供了Shell—NotifyIcon函数，用它可以增加、删除或者修改托盘中的图标，在托盘上放置图标后，Windows Shell会负责把发生在图标上的鼠标事件通知应用程序。Shell—NotifyIcon函数定义如下： WINSHELLAPI BOOL WINAPI Shell—NotifyIcon(DWORD dwMessage,PNOTIFYICONDATA pnid); dwMessage表示要完成的操作：NIM—ADD(增加图标)、NIM—DELETE(删除图标)、NIM—MODIFY(修改图标或提示文本)，pnid是一个指向NOTIFYICONDATA结构的指针，结构的定义如下： typedef struct —NOTIFYICONDATA{ DWORD cbSize;//结构所占的字节数，必须用结构的大小来初始化。 HWND hWnd;//接受Tray图标消息的窗口句柄 UINT uID;//由应用程序定义的图标ID UINT uFlags;//用来鉴别那些需要改变其值的域，NIF_ICON表示hIcon有效，可用来修改图标，NIF_MESSAGE表示uCallbackMessage有效，用来定义消息，NIF—TIP表示szTip参数有效，可修改工具提示。 UINT uCallbackMessage;//应用程序定义的消息 HICON hIcon;//Tray图标的句柄 char szTip[64];//工具提示的文本 }NOTIFYICONDATA; 下面我们就通过一个具体例子来说明实现方法，程序运行时不会显示主窗体，只在托盘上增加一个图标，双击图标可关闭程序。 程序运行时托盘区显示如下： 新建一个工程，放置一个Timer控件到窗体上。打开unit1.h文件，增加头文件说明＃include <shellapi.h>，在TForm1定义的private段增加一些数据成员和方法的声明： unsigned int iconmessage;//定义的消息 void AddTrayIcon();//在托盘上增加图标 void RemoveTrayIcon();//从托盘中删除图标 由于要增加对自定义消息的处理，所以必须重载窗口过程函数WndProc，在TForm1的定义中增加protected段：virtual void ——fastcall WndProc(Messages::Tmessage＆ Message); 在unit1.cpp中定义相应的成员函数： void TForm1::AddTrayIcon() { NOTIFYICONDATA icondata; memset(＆icondata,0,sizeof(icondata)); //将结构icondata的各域初始化为0 icondata.cbSize=sizeof(icondata); icondata.hWnd=Handle; strncpy(icondata.szTip,″未知状态″,sizeof(icondata.szTip)); icondata.hIcon=Application－>Icon－>Handle; icondata.uCallbackMessage=iconmessage; icondata.uFlags=NIF—MESSAGE|NIF—ICON|NIF—TIP; Shell—NotifyIcon(NIM—ADD,＆icondata); } void TForm1::RemoveTrayIcon() { NOTIFYICONDATA icondata; memset(＆icondata,0,sizeof(icondata)); icondata.cbSize=sizeof(icondata); icondata.hWnd=Handle; Shell—NotifyIcon(NIM—DELETE,＆icondata); } 重载TForm1的WndProc函数，加入对自定义消息的处理代码，这其实相当于创建了TForm类的子类。 void __fastcall TForm1::WndProc(Messages::TMessage＆ Message) { if(Message.Msg==iconmessage) { if(Message.LParam==WM—LBUTTONDBLCLK) { Application－>Terminate(); //如果双击图标，则关闭应用程序 } return; } TForm::WndProc(Message);//对于其他的消息，调用基础类的WndProc函数让Windows进行缺省处理。 } 创建窗体的OnCreate事件句柄: void ——fastcall TForm1::FormCreate(TObject ＊Sender) { iconmessage=RegisterWindowMessage(″IconNotify″); AddTrayIcon(); } 这里通过调用RegisterWindowMessage函数来定义一个用户消息，也可以通过WM_USER＋n来获得一个系统没有使用的消息编号。 void ——fastcall TForm1::FormDestroy(TObject ＊Sender) { RemoveTrayIcon(); //窗体在关闭时删除托盘中的图标 } 编写Timer1的Timer事件代码，当用户将鼠标停留在图标上时，显示提示文本： void ——fastcall TForm1::Timer1Timer(TObject ＊Sender) { NOTIFYICONDATA icondata; memset (＆icondata, 0, sizeof (icondata)); icondata.cbSize = sizeof (icondata); icondata.hWnd = Handle; String s=″我的图标!″;//定义提示文本 strncpy (icondata.szTip, s.c_str(), sizeof (icondata.szTip)); icondata.uFlags = NIF—TIP ; Shell—NotifyIcon (NIM—MODIFY,＆icondata); } 程序运行时不显示主窗体，只在托盘上放置相应的程序图标，从C＋＋ Builder主选单中选择View|Project Source，在WinMain函数的Application→Initialize()语句后增加代码： ShowWindow(Application→Handle,SW—HIDE); Application→ShowMainForm=false; 按F9编译并运行程序，托盘上就会出现相应的图标。以上代码在C＋＋ Builder3、Pwin98环境下编译、运行通过。