Tray(托盘)是Windows9x任务条上的一个特殊区域,它的技术名称为“任务栏布告区”,一些软件(如金山词霸Ⅲ)运行时会在托盘上放置一个图标,使用户一眼就能知道这个程序正在后台运行,要想激活它也很容易,通常只需单击一下这个图标即可,非常方便。
Tray的编程比较特殊,但并不难,主要包括图标、工具提示和消息等三个方面,它是Shell编程的一部分。ShellAPI提供了Shell-NotifyIcon函数,用它可以增加、删除或者修改托盘中的图标,在托盘上放置图标后,Windows Shell会负责把发生在图标上的鼠标事件通知应用程序。Shell-NotifyIcon函数定义如下:
1 |
WINSHELLAPI BOOL WINAPI Shell-NotifyIcon(DWORD dwMessage,PNOTIFYICONDATA pnid); |
dwMessage表示要完成的操作:NIM-ADD(增加图标)、NIM-DELETE(删除图标)、NIM-MODIFY(修改图标或提示文本),pnid是一个指向NOTIFYICONDATA结构的指针,结构的定义如下:
1 2 3 4 5 6 7 8 9 |
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段增加一些数据成员和方法的声明:
1 2 3 |
unsigned int iconmessage;//定义的消息 void AddTrayIcon();//在托盘上增加图标 void RemoveTrayIcon();//从托盘中删除图标 |
由于要增加对自定义消息的处理,所以必须重载窗口过程函数WndProc,在TForm1的定义中增加protected段:
1 |
virtual void __fastcall WndProc(Messages::Tmessage& Message); |
在unit1.cpp中定义相应的成员函数:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
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类的子类。
1 2 3 4 5 6 7 8 9 10 11 12 13 |
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事件句柄:
1 2 3 4 5 |
void __fastcall TForm1::FormCreate(TObject *Sender) { iconmessage=RegisterWindowMessage(″IconNotify″); AddTrayIcon(); } |
这里通过调用RegisterWindowMessage函数来定义一个用户消息,也可以通过WM_USER+n来获得一个系统没有使用的消息编号。
1 2 3 4 5 |
void __fastcall TForm1::FormDestroy(TObject *Sender) { RemoveTrayIcon(); //窗体在关闭时删除托盘中的图标 } |
编写Timer1的Timer事件代码,当用户将鼠标停留在图标上时,显示提示文本:
1 2 3 4 5 6 7 8 9 10 11 |
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()语句后增加代码:
1 2 |
ShowWindow(Application→Handle,SW-HIDE); Application→ShowMainForm=false; |
按F9编译并运行程序,托盘上就会出现相应的图标。以上代码在C++ Builder3、Pwin98环境下编译、运行通过。