对话框托盘程序实现源码
by 郭世龙
对于不需要占据太多屏幕资源的后台程序,最好的处理方法就是使用系统的托盘,在托盘显示一个图标,必要时通过其激活主窗口。本文介绍对话框托盘图表的实现方法并附源码。
托盘程序的设计主要满足以下几个需求:
(1)程序启动时主窗口隐藏,只在托盘显示图标;
(2)主窗口隐藏时,在任务栏没有图标显示;
(3)在托盘图标点击右键弹出,菜单用来恢复、隐藏、退出程序。
实现托盘程序主要涉及一个shell函数Shell_NotifyIcon和一个用来描述托盘图标信息的结构体NOTIFYICONDATA。
Shell_NotifyIcon函数
函数Shell_NotifyIcon()用于在托盘上增加、删除或修改图标。其原型为:
WINSHELLAPI BOOL WINAPI Shell_NotifyIcon( DWORD dwMessage,PNOTIFYICONDATA pnid);
Pnid是一个指向NOTIFYICONDATA结构的指针。
dwMessage是被传递的消息,可以是以下消息之一:
NIM_ADD: 在托盘上添加图标 ;
NIM_DELETE:删除托盘上的图标;
NIM_MODIFY:修改托盘上的图标 。
NOTIFYICONDATA结构
NOTIFYICONDATA结构包含了系统用来处理托盘图标的信息,它包括选择的图标、回调消息、提示消息和图标对应的窗口等内容。其定义为:
typedef struct _NOTIFYICONDATA
{
DWORD cbSize; //以字节为单位的这个结构的大小
HWND hWnd; //接收托盘图标通知消息的窗口句柄
UINT uID; //应用程序定义的该图标的ID号
UINT uFlags; //设置该图标的属性
UINT uCallbackMessage; //应用程序定义的消息ID号,此消息传递给hWnd
HICON hIcon; //用来添加、删除、修改图标的句柄
char szTip[64]; //鼠标停留在图标上显示的提示信息
} NOTIFYICONDATA, *PNOTIFYICONDATA;
DWORD cbSize; //以字节为单位的这个结构的大小
HWND hWnd; //接收托盘图标通知消息的窗口句柄
UINT uID; //应用程序定义的该图标的ID号
UINT uFlags; //设置该图标的属性
UINT uCallbackMessage; //应用程序定义的消息ID号,此消息传递给hWnd
HICON hIcon; //用来添加、删除、修改图标的句柄
char szTip[64]; //鼠标停留在图标上显示的提示信息
} NOTIFYICONDATA, *PNOTIFYICONDATA;
该结构中,成员uFlags可以是下列的组合或其中之一:
NIF_ICON:设置成员hIcon有效
NIF_MESSAGE:设置成员uCallbackMessage有效
NIF_TIP:设置成员szTip有效
NIF_ICON:设置成员hIcon有效
NIF_MESSAGE:设置成员uCallbackMessage有效
NIF_TIP:设置成员szTip有效
对话框托盘图标程序
在IcoTrayDlg.h 中定义返回消息ID, #define MYWM_NOTIFYICON WM_USER+100。在CIcoTrayDlg类中加入NOTIFYICONDATA结构的成员变量m_NotiIcon。并在其OnInitDialog函数中加入初始化该结构体的代码:
m_NotiIcon.cbSize=sizeof(NOTIFYICONDATA);
m_NotiIcon.hWnd=this->m_hWnd;
m_NotiIcon.uFlags=NIF_MESSAGE|NIF_ICON|NIF_TIP;
m_NotiIcon.uCallbackMessage=MYWM_NOTIFYICON; //用户定义的回调消息
CString szToolTip =_T("托盘实例");
_tcscpy(m_NotiIcon.szTip, szToolTip);
m_NotiIcon.uID=IDR_MAINFRAME;
HICON hIcon=AfxGetApp()->LoadIcon(IDR_MAINFRAME);
m_NotiIcon.hIcon=hIcon;
::Shell_NotifyIcon(NIM_ADD,&m_NotiIcon);
if(hIcon)::DestroyIcon(hIcon);
消息响应
添加了以上的代码之后我们完成了在托盘上添加图标。但是单击图标对话框没有相应的响应。这是因为我们还没有处理我们定义的返回消息。为了处理图标返回的左 键双击鼠标消息和右键单击鼠标消息,我们需要重载WindowProc()函数。以及为了不让对话框最小化时图标不在任务栏上出现,我们还需要在在此函数 中处理最小化的系统消息。
在IcoTrayDlg.h 中添加重载定义LRESULT WindowProc(UINT message, WPARAM wParam, LPARAM lParam);
在IcoTrayDlg.cpp中定义
LRESULT CIcoTrayDlg::WindowProc(UINT message, WPARAM wParam, LPARAM lParam)
{
switch(message)
{
case MYWM_NOTIFYICON://如果是用户定义的消息
if(lParam==WM_LBUTTONDBLCLK)
{ //鼠标双击时主窗口出现
AfxGetApp()->m_pMainWnd->ShowWindow(SW_SHOW);
}
else if(lParam==WM_RBUTTONDOWN)
{ //鼠标右键单击弹出选单
CMenu menu;
menu.LoadMenu(IDR_RIGHT_MENU); //载入事先定义的选单
CMenu* pMenu=menu.GetSubMenu(0);
CPoint pos;
GetCursorPos(&pos);
pMenu->TrackPopupMenu(TPM_LEFTALIGN|TPM_RIGHTBUTTON,pos.x,pos.y,
LRESULT CIcoTrayDlg::WindowProc(UINT message, WPARAM wParam, LPARAM lParam)
{
switch(message)
{
case MYWM_NOTIFYICON://如果是用户定义的消息
if(lParam==WM_LBUTTONDBLCLK)
{ //鼠标双击时主窗口出现
AfxGetApp()->m_pMainWnd->ShowWindow(SW_SHOW);
}
else if(lParam==WM_RBUTTONDOWN)
{ //鼠标右键单击弹出选单
CMenu menu;
menu.LoadMenu(IDR_RIGHT_MENU); //载入事先定义的选单
CMenu* pMenu=menu.GetSubMenu(0);
CPoint pos;
GetCursorPos(&pos);
pMenu->TrackPopupMenu(TPM_LEFTALIGN|TPM_RIGHTBUTTON,pos.x,pos.y,
AfxGetMainWnd() );
}
break;
}
break;
case WM_SYSCOMMAND://如果是系统消息
if(wParam==SC_MINIMIZE)
{
//接收到最小化消息时主窗口隐藏
AfxGetApp()->m_pMainWnd->ShowWindow(SW_HIDE);
return 0;
}
break;
}
return CWnd::WindowProc(message, wParam, lParam);
}
if(wParam==SC_MINIMIZE)
{
//接收到最小化消息时主窗口隐藏
AfxGetApp()->m_pMainWnd->ShowWindow(SW_HIDE);
return 0;
}
break;
}
return CWnd::WindowProc(message, wParam, lParam);
}
右键菜单
在此之前我们还需要添加一个ID为IDR_RIGHT_MENU的菜单,这个菜单应该包括:打开、隐藏、退出等基本功能。在ClclTrayDlg中添加事件响应。
//右键菜单消息事件处理函数
void CIcoTrayDlg::OnAppOpen()
{
AfxGetApp()->m_pMainWnd->ShowWindow(SW_SHOW); //点击"打开"时显示对话框
}
void CIcoTrayDlg::OnAppOpen()
{
AfxGetApp()->m_pMainWnd->ShowWindow(SW_SHOW); //点击"打开"时显示对话框
}
void CIcoTrayDlg::OnAppHide()
{
AfxGetApp()->m_pMainWnd->ShowWindow(SW_HIDE); //在点击“隐藏”时隐藏对话框
}
{
AfxGetApp()->m_pMainWnd->ShowWindow(SW_HIDE); //在点击“隐藏”时隐藏对话框
}
void CIcoTrayDlg::OnAppExit()
{
::PostMessage(m_hWnd,WM_QUIT,0,0); //在点击“退出”时退出程序
}
{
::PostMessage(m_hWnd,WM_QUIT,0,0); //在点击“退出”时退出程序
}
为使应用程序退出时去掉托盘上的图标,我们需要映射WM_DESTROY消息并在其响应函数在OnDestroy()函数中加入:
::Shell_NotifyIcon(NIM_DELETE,&&m_tnid);
::Shell_NotifyIcon(NIM_DELETE,&&m_tnid);
启动隐藏对话框
一般的后台程序程序启动时不需要弹出对话框,只有在用户需要时候才双击托盘图标弹出对话框。启动隐藏对话框的方法有多种这里使用了比较简单的一种即不绘制窗口。当对话框显示时将要响应消息WM_PAINT绘制客户区,相应消息WM_NCPAINT绘制窗口边框。我们在窗口第一次自绘自身时隐藏窗口,可以收到比较良好的效果。由于窗口是先画窗口边框,所以我们仅需处理WM_NCPAINT即可。代码如下:
//隐藏窗口
void CIcoTrayDlg::OnNcPaint()
{
CDialog::OnNcPaint()
static int i = 2;
if(i > 0)
{
i --;
ShowWindow(SW_HIDE);
}
else
{
CDialog::OnNcPaint();
}
void CIcoTrayDlg::OnNcPaint()
{
CDialog::OnNcPaint()
static int i = 2;
if(i > 0)
{
i --;
ShowWindow(SW_HIDE);
}
else
{
CDialog::OnNcPaint();
}
}
为什么要定义静态变量i而且设其值为2呢?
我们只要窗口隐藏第一次,所以定义这个变量可以判断是否时首次显示窗口。当程序开始运行时,系统发送(SendMessage)WM_NCPAINT消息,此时程序的窗口边框应该被显示,但是此时我们没有作任何显示的操作,而是将窗口隐藏,ShowWindow(SW_HIDE)将把窗口的 WS_VISIBLE属性去掉,继续执行,程序将检查WS_VISIBLE属性,如果没有则显示窗口,所以又发送了一个WM_NCPAINT消息。所以我们要处理两次WM_NCPAINT消息。在需要窗口显示时,调用ShowWindow(SW_SHOW)即可。程序执行的结果是,原来处于激活状态的窗口可能会闪动两下,然后仍然处于激活状态。
Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=1743314