Tray的編程比較特殊,但并不難,主要包括圖標、工具提示和消息等三個方面,它是Shell編程的一部分。ShellAPI提供了Shell—NotifyIcon函數(shù),用它可以增加、刪除或者修改托盤中的圖標,在托盤上放置圖標后,Windows Shell會負責(zé)把發(fā)生在圖標上的鼠標事件通知應(yīng)用程序。Shell—NotifyIcon函數(shù)定義如下:
WINSHELLAPI BOOL WINAPI Shell—NotifyIcon(DWORD dwMessage,PNOTIFYICONDATA pnid);
dwMessage表示要完成的操作:NIM—ADD(增加圖標)、NIM—DELETE(刪除圖標)、NIM—MODIFY(修改圖標或提示文本),pnid是一個指向NOTIFYICONDATA結(jié)構(gòu)的指針,結(jié)構(gòu)的定義如下:
typedef struct —NOTIFYICONDATA{
DWORD cbSize;//結(jié)構(gòu)所占的字節(jié)數(shù),必須用結(jié)構(gòu)的大小來初始化。
HWND hWnd;//接受Tray圖標消息的窗口句柄
UINT uID;//由應(yīng)用程序定義的圖標ID
UINT uFlags;//用來鑒別那些需要改變其值的域,NIF_ICON表示hIcon有效,可用來修改圖標,NIF_MESSAGE表示uCallbackMessage有效,用來定義消息,NIF—TIP表示szTip參數(shù)有效,可修改工具提示。
UINT uCallbackMessage;//應(yīng)用程序定義的消息
HICON hIcon;//Tray圖標的句柄
char szTip[64];//工具提示的文本
}NOTIFYICONDATA;
下面我們就通過一個具體例子來說明實現(xiàn)方法,程序運行時不會顯示主窗體,只在托盤上增加一個圖標,雙擊圖標可關(guān)閉程序。
程序運行時托盤區(qū)顯示如下:
新建一個工程,放置一個Timer控件到窗體上。打開unit1.h文件,增加頭文件說明#include
unsigned int iconmessage;//定義的消息
void AddTrayIcon();//在托盤上增加圖標
void RemoveTrayIcon();//從托盤中刪除圖標
由于要增加對自定義消息的處理,所以必須重載窗口過程函數(shù)WndProc,在TForm1的定義中增加protected段:virtual void ——fastcall WndProc(Messages::Tmessage& Message);
在unit1.cpp中定義相應(yīng)的成員函數(shù):
void TForm1::AddTrayIcon()
{
NOTIFYICONDATA icondata;
memset(&icondata,0,sizeof(icondata));
//將結(jié)構(gòu)icondata的各域初始化為0
icondata.cbSize=sizeof(icondata);
icondata.hWnd=Handle;
strncpy(icondata.szTip,″未知狀態(tài)″,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函數(shù),加入對自定義消息的處理代碼,這其實相當(dāng)于創(chuàng)建了TForm類的子類。
void __fastcall TForm1::WndProc(Messages::TMessage& Message)
{
if(Message.Msg==iconmessage)
{
if(Message.LParam==WM—LBUTTONDBLCLK)
{
Application->Terminate();
//如果雙擊圖標,則關(guān)閉應(yīng)用程序
}
return;
}
TForm::WndProc(Message);//對于其他的消息,調(diào)用基礎(chǔ)類的WndProc函數(shù)讓W(xué)indows進行缺省處理。
}
創(chuàng)建窗體的OnCreate事件句柄:
void ——fastcall TForm1::FormCreate(TObject *Sender)
{
iconmessage=RegisterWindowMessage(″IconNotify″);
AddTrayIcon();
}
這里通過調(diào)用RegisterWindowMessage函數(shù)來定義一個用戶消息,也可以通過WM_USER+n來獲得一個系統(tǒng)沒有使用的消息編號。
void ——fastcall TForm1::FormDestroy(TObject *Sender)
{
RemoveTrayIcon();
//窗體在關(guān)閉時刪除托盤中的圖標
}
編寫Timer1的Timer事件代碼,當(dāng)用戶將鼠標停留在圖標上時,顯示提示文本:
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);
}
程序運行時不顯示主窗體,只在托盤上放置相應(yīng)的程序圖標,從C++ Builder主選單中選擇View Project Source,在WinMain函數(shù)的Application→Initialize()語句后增加代碼:
ShowWindow(Application→Handle,SW—HIDE);
Application→ShowMainForm=false;
按F9編譯并運行程序,托盤上就會出現(xiàn)相應(yīng)的圖標。以上代碼在C++ Builder3、Pwin98環(huán)境下編譯、運行通過。