用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环境下编译、运行通过。