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