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環境下編譯、運行通過。