利用Visual C++實現(xiàn)系統(tǒng)托盤程序
自從微軟公司推出Windows 95操作系統(tǒng)以來,系統(tǒng)托盤應(yīng)用作為一種極具吸引力的用戶界面設(shè)計深受廣大用戶的喜愛。使用系統(tǒng)托盤作為用戶界面的Windows應(yīng)用程序數(shù)不勝數(shù),比如"金山詞霸"、"Winamp"、"RealPlayer"等等。
這些程序運行時不顯示運行窗口,只在任務(wù)欄上顯示一個圖標,表示程序正在運行,用戶可以通過鼠標與應(yīng)用程序交互,程序開發(fā)人員有時也需要編制一些僅在后臺運行的類似程序,為了不干擾前臺程序的運行界面和不顯示不必要的窗口,應(yīng)使程序運行時的主窗口不可見。同時將一個圖標顯示在任務(wù)欄右端靜態(tài)通告區(qū)中并響應(yīng)用戶的鼠標動作。本實例就介紹Visual C++開發(fā)這類程序的設(shè)計方法,該程序編譯運行后,如果雙擊托盤圖標,程序會彈出一個消息列表窗口,只要鼠標在托盤圖標上移動或點擊(無論是左右鍵的單擊或雙擊),產(chǎn)生的消息都會顯示在這個窗口里;當鼠標光標移到托盤圖標上時,在圖標附近會顯示提示信息;單擊右鍵時彈出上下文菜單,這個菜單中應(yīng)包含打開屬性頁的命令或者打開與圖標相關(guān)的其它窗口的命令,另外,該程序還可以動態(tài)的改變托盤的圖標。參照這個例子,相信讀者能輕松自如地在自己的程序中應(yīng)用系統(tǒng)托盤。
一、實現(xiàn)方法
為了實現(xiàn)拖盤程序,首先要使程序的主窗口不可見,這點實現(xiàn)起來十分容易,只要調(diào)用ShowWindow(SW_HIDE)就可以了,本實例采用的就是這種方法,還有一種思路是通過分別設(shè)置主邊框窗口的風格和擴展風格來隱藏主框架:
BOOL CMainFrame::PreCreateWindow(CREATESTRUCT& cs)
{
cs.style =WS_POPUP;//使主窗口不可見;
cs.dwExStyle =WS_EX_TOOLWINDOW;//不顯示任務(wù)按鈕;
return CFrameWnd::PreCreateWindow(cs);
}
在任務(wù)條上顯示圖標是利用系統(tǒng)API函數(shù)Shell_NotifyIcon()來將一個圖標顯示在任務(wù)欄的通告區(qū)中。該函數(shù)的原型為:
BOOL Shell_NotifyIcon(DWORD dwMessage, PNOTIFYICONDATA pnid);
該函數(shù)的第一個參數(shù)dwMessage類型為DWORD,表示要進行的動作,它可以是下面的值之一:
NIM_ADD: 添加一個圖標到任務(wù)欄。
NIM_MODIFY: 修改狀態(tài)欄區(qū)域的圖標。
NIM_DELETE: 刪除狀態(tài)欄區(qū)域的圖標。
NIM_SETFOCUS: 將焦點返回到任務(wù)欄通知區(qū)域。當完成用戶界面操作時,任務(wù)欄圖標必須用此消息。例如,如果任務(wù)欄圖標正顯示上下文菜單,但用戶按下"ESCAPE"鍵取消操作,這時就必須用此消息將焦點返回到任務(wù)欄通知區(qū)域。
NIM_SETVERSION:指示任務(wù)欄按照相應(yīng)的動態(tài)庫版本工作。
第二個參數(shù)pnid是NOTIFYICONDATA結(jié)構(gòu)的地址,其內(nèi)容視dwMessage的值而定。這個結(jié)構(gòu)在SHELLAPI.H文件中定義如下:
typedef struct _NOTIFYICONDATA {
DWORD cbSize; // 結(jié)構(gòu)大?。╯izeof struct),必須設(shè)置
HWND hWnd; // 發(fā)送通知消息的窗口句柄
UINT uID; // 圖標ID ( 由回調(diào)函數(shù)的WPARAM 指定)
UINT uFlags;
UINT uCallbackMessage; // 消息被發(fā)送到此窗口過程
HICON hIcon; // 任務(wù)欄圖標句柄
CHAR szTip[64]; // 提示文本
} NOTIFYICONDATA;
該結(jié)構(gòu)中uFlags的值分別為:
#define NIF_MESSAGE 0x1 // 表示uCallbackMessage 有效
#define NIF_ICON 0x2 // 表示hIcon 有效
#define NIF_TIP 0x4 // 表示szTip 有效
在該結(jié)構(gòu)的成員中,cbSize為該結(jié)構(gòu)所占的字節(jié)數(shù),hWnd為接受該圖標所發(fā)出的消息的窗口的句柄(鼠標在任務(wù)欄上程序圖標上動作時圖標將發(fā)出消息,這個消息用戶要自己定義),uID為被顯示圖標的ID,uFlags指明其余的幾個成員(hIcon、uCallBackMessage和szTip)的值是否有效,uCallbackMessage為一個用戶自定義的消息,當用戶在該圖標上作用一些鼠標動作時,圖標將向應(yīng)用程序的主框架窗口(hWnd成員中指定的窗口)發(fā)出該消息,為了使程序的主框架得到該通知消息,需要設(shè)置NOTIFYICONDATA 結(jié)構(gòu)的flag成員的值為NIF_MESSAGE。hIcon為將在任務(wù)欄上顯示的圖標句柄,szTip鼠標停留在該圖標上時顯示的提示字符串。
盡管Shell_NotifyIcon函數(shù)簡單實用,但它畢竟是個Win32 API,為此本實例將它封裝在了一個C++類中,這個類叫做CTrayIcon,有了它,托盤編程會更加輕松自如,因為它隱藏了NOTIFYICONDATA、消息代碼、標志以及一些繁瑣的細節(jié)。
二、編程步驟
1、 啟動Visual C++6.0,生成一個單文檔的應(yīng)用程序TrayTest,取消文檔視圖支持;
2、 在CMainFrame類中添加自定義消息#define WM_MY_TRAY_NOTIFICATION WM_USER+0,并在該類中為此自定義消息手動添加消息映射ON_MESSAGE(WM_MY_TRAY_NOTIFICATION, OnTrayNotification)和消息響應(yīng)函數(shù)afx_msg LRESULT OnTrayNotification(WPARAM wp, LPARAM lp);
3、 設(shè)計二個圖標添加到項目中,其ID標志分別為"IDI_MYICON"、"IDI_MYICON2",作為托盤顯示時的圖標;
4、 在CMainFrame類中添加下述變量: CTrayIcon m_trayIcon(用來操作圖標的類對象)、CEdit m_wndEdit(編輯框用來顯示所跟蹤到的鼠標消息)、int m_iWhichIcon(決定當前托盤使用哪個圖標)、BOOL m_bShutdown(是否關(guān)閉當前拖盤程序標志)、BOOL m_bShowTrayNotifications(是否顯示托盤消息標志);
5、 為程序的IDR_MAINFRAME添加處理菜單項和托盤的上下文菜單IDI_TRAYICON(具體的菜單項的標題和ID標志符參見代碼部分),然后使用Class Wizard為各個菜單項添加處理函數(shù);
6、 添加代碼,編譯運行程序。
///////////////////////////////////////////////CTrayIcon類的頭文件;
#ifndef _TRAYICON_H
#define _TRAYICON_H
class CTrayIcon : public CCmdTarget {
protected:
DECLARE_DYNAMIC(CTrayIcon)
NOTIFYICONDATA m_nid; // struct for Shell_NotifyIcon args
public:
CTrayIcon(UINT uID);
~CTrayIcon();
// Call this to receive tray notifications
void SetNotificationWnd(CWnd* pNotifyWnd, UINT uCbMsg);
BOOL SetIcon(UINT uID); // main variant you want to use
BOOL SetIcon(HICON hicon, LPCSTR lpTip);
BOOL SetIcon(LPCTSTR lpResName, LPCSTR lpTip)
{ return SetIcon(lpResName ?
AfxGetApp()->LoadIcon(lpResName) : NULL, lpTip); }
BOOL SetStandardIcon(LPCTSTR lpszIconName, LPCSTR lpTip)
{ return SetIcon(::LoadIcon(NULL, lpszIconName), lpTip); }
virtual LRESULT OnTrayNotification(WPARAM uID, LPARAM lEvent);
};
#endif
///////////////////////////////////////////////////CTrayIcon類的.CPP文件
#include "stdafx.h"
#include "trayicon.h"
#include // for AfxLoadString
IMPLEMENT_DYNAMIC(CTrayIcon, CCmdTarget)
CTrayIcon::CTrayIcon(UINT uID)
{
memset(&m_nid, 0 , sizeof(m_nid)); // Initialize NOTIFYICONDATA
m_nid.cbSize = sizeof(m_nid);
m_nid.uID = uID; // never changes after construction
AfxLoadString(uID, m_nid.szTip, sizeof(m_nid.szTip));
// Use resource string as tip if there is one
}
CTrayIcon::~CTrayIcon()
{
SetIcon(0); // remove icon from system tray
}
void CTrayIcon::SetNotificationWnd(CWnd* pNotifyWnd, UINT uCbMsg)
{
// Set notification window. It must created already.
ASSERT(pNotifyWnd==NULL::IsWindow(pNotifyWnd->GetSafeHwnd()));
m_nid.hWnd = pNotifyWnd->GetSafeHwnd();
ASSERT(uCbMsg==0uCbMsg>=WM_USER);
m_nid.uCallbackMessage = uCbMsg;
}
BOOL CTrayIcon::SetIcon(UINT uID)
{
// Sets both the icon and tooltip from resource ID ,To remove the icon, call SetIcon(0)
HICON hicon=NULL;
if (uID) {
AfxLoadString(uID, m_nid.szTip, sizeof(m_nid.szTip));
hicon = AfxGetApp()->LoadIcon(uID);
}
return SetIcon(hicon, NULL);
}
BOOL CTrayIcon::SetIcon(HICON hicon, LPCSTR lpTip)
{
// Common SetIcon for all overloads.
UINT msg;
m_nid.uFlags = 0;
if (hicon) {
// Set the icon
msg = m_nid.hIcon ? NIM_MODIFY : NIM_ADD;
m_nid.hIcon = hicon; // Add or replace icon in system tray
m_nid.uFlags= NIF_ICON;
} else {
if (m_nid.hIcon==NULL) // remove icon from tray
return TRUE; // already deleted
msg = NIM_DELETE;
}
if (lpTip) // Use the tip, if any
strncpy(m_nid.szTip, lpTip, sizeof(m_nid.szTip));
if (m_nid.szTip[0])
m_nid.uFlags= NIF_TIP;
if (m_nid.uCallbackMessage && m_nid.hWnd) // Use callback if any
m_nid.uFlags= NIF_MESSAGE;
BOOL bRet = Shell_NotifyIcon(msg, &m_nid); // Do it
if (msg==NIM_DELETE!bRet)
m_nid.hIcon = NULL; // failed
return bRet;
}
LRESULT CTrayIcon::OnTrayNotification(WPARAM wID, LPARAM lEvent)
{
if (wID!=m_nid.uID(lEvent!=WM_RBUTTONUP && lEvent!=WM_LBUTTONDBLCLK))
return 0;
CMenu menu;//裝載上下文菜單;
if (!menu.LoadMenu(m_nid.uID))
return 0;
CMenu* pSubMenu = menu.GetSubMenu(0);
if (!pSubMenu)
return 0;
if (lEvent==WM_RBUTTONUP) {//設(shè)置第一個菜單項為默認菜單項目
::SetMenuDefaultItem(pSubMenu->m_hMenu, 0, TRUE);
//將當前菜單作為上下文菜單;
CPoint mouse;
GetCursorPos(&mouse);
::SetForegroundWindow(m_nid.hWnd);
::TrackPopupMenu(pSubMenu->m_hMenu, 0, mouse.x, mouse.y, 0,m_nid.hWnd, NULL);
} else // double click: execute first menu item
::SendMessage(m_nid.hWnd, WM_COMMAND, pSubMenu->GetMenuItemID(0), 0);
return 1;
}
///////////////////////////////// MainFrm.h : interface of the CMainFrame class
#if !defined(AFX_MAINFRM_H__9ED70A69_C975_4F20_9D4E_B2877E3575D0__INCLUDED_)
#define AFX_MAINFRM_H__9ED70A69_C975_4F20_9D4E_B2877E3575D0__INCLUDED_
#if _MSC_VER >1000
#pragma once
#endif // _MSC_VER >1000
#include "trayicon.h"
class CMainFrame : public CFrameWnd
{
public:
CMainFrame();
protected:
DECLARE_DYNAMIC(CMainFrame)
// Attributes
public:
// Overrides
// ClassWizard generated virtual function overrides
//{{AFX_VIRTUAL(CMainFrame)
//}}AFX_VIRTUAL
// Implementation
public:
virtual ~CMainFrame();
#ifdef _DEBUG
virtual void AssertValid() const;
virtual void Dump(CDumpContext& dc) const;
#endif
protected: // control bar embedded members
CStatusBar m_wndStatusBar;
CTrayIcon m_trayIcon; // my tray icon
CEdit m_wndEdit; // to display tray notifications
int m_iWhichIcon; // which HICON to use
BOOL m_bShutdown; // OK to terminate TRAYTEST
BOOL m_bShowTrayNotifications; // display info in main window
// Generated message map functions
protected:
//{{AFX_MSG(CMainFrame)
afx_msg LRESULT OnTrayNotification(WPARAM wp, LPARAM lp);
afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
afx_msg void OnToggleIcon();
afx_msg void OnViewClear();
afx_msg void OnViewNotifications();
afx_msg void OnUpdateViewClear(CCmdUI* pCmdUI);
afx_msg void OnUpdateViewNotifications(CCmdUI* pCmdUI);
afx_msg void OnClose();
afx_msg void OnAppOpen();
afx_msg void OnAppSuspend();
// NOTE - the ClassWizard will add and remove member functions here.
// DO NOT EDIT what you see in these blocks of generated code!
//}}AFX_MSG
DECLARE_MESSAGE_MAP()
};
///////////////////////////////////////////////CMainFrm.cpp
#include "stdafx.h"
#include "TrayTest.h"
#include "MainFrm.h"
#ifdef _DEBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[] = __FILE__;
#endif
LRESULT CTrayIcon::OnTrayNotification(WPARAM wID, LPARAM lEvent)
{
if (wID!=m_nid.uID(lEvent!=WM_RBUTTONUP && lEvent!=WM_LBUTTONDBLCLK))
return 0;
CMenu menu;//裝載上下文菜單;
if (!menu.LoadMenu(m_nid.uID))
return 0;
CMenu* pSubMenu = menu.GetSubMenu(0);
if (!pSubMenu)
return 0;
if (lEvent==WM_RBUTTONUP) {//設(shè)置第一個菜單項為默認菜單項目
::SetMenuDefaultItem(pSubMenu->m_hMenu, 0, TRUE);
//將當前菜單作為上下文菜單;
CPoint mouse;
GetCursorPos(&mouse);
::SetForegroundWindow(m_nid.hWnd);
::TrackPopupMenu(pSubMenu->m_hMenu, 0, mouse.x, mouse.y, 0,m_nid.hWnd, NULL);
} else // double click: execute first menu item
::SendMessage(m_nid.hWnd, WM_COMMAND, pSubMenu->GetMenuItemID(0), 0);
return 1;
}
///////////////////////////////// MainFrm.h : interface of the CMainFrame class
#if !defined(AFX_MAINFRM_H__9ED70A69_C975_4F20_9D4E_B2877E3575D0__INCLUDED_)
#define AFX_MAINFRM_H__9ED70A69_C975_4F20_9D4E_B2877E3575D0__INCLUDED_
#if _MSC_VER >1000
#pragma once
#endif // _MSC_VER >1000
#include "trayicon.h"
class CMainFrame : public CFrameWnd
{
public:
CMainFrame();
protected:
DECLARE_DYNAMIC(CMainFrame)
// Attributes
public:
// Overrides
// ClassWizard generated virtual function overrides
//{{AFX_VIRTUAL(CMainFrame)
//}}AFX_VIRTUAL
// Implementation
public:
virtual ~CMainFrame();
#ifdef _DEBUG
virtual void AssertValid() const;
virtual void Dump(CDumpContext& dc) const;
#endif
protected: // control bar embedded members
CStatusBar m_wndStatusBar;
CTrayIcon m_trayIcon; // my tray icon
CEdit m_wndEdit; // to display tray notifications
int m_iWhichIcon; // which HICON to use
BOOL m_bShutdown; // OK to terminate TRAYTEST
BOOL m_bShowTrayNotifications; // display info in main window
// Generated message map functions
protected:
//{{AFX_MSG(CMainFrame)
afx_msg LRESULT OnTrayNotification(WPARAM wp, LPARAM lp);
afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
afx_msg void OnToggleIcon();
afx_msg void OnViewClear();
afx_msg void OnViewNotifications();
afx_msg void OnUpdateViewClear(CCmdUI* pCmdUI);
afx_msg void OnUpdateViewNotifications(CCmdUI* pCmdUI);
afx_msg void OnClose();
afx_msg void OnAppOpen();
afx_msg void OnAppSuspend();
// NOTE - the ClassWizard will add and remove member functions here.
// DO NOT EDIT what you see in these blocks of generated code!
//}}AFX_MSG
DECLARE_MESSAGE_MAP()
};
///////////////////////////////////////////////CMainFrm.cpp
#include "stdafx.h"
#include "TrayTest.h"
#include "MainFrm.h"
#ifdef _DEBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[] = __FILE__;
#endif
/////////////////////////////////////////////////////////////////////////////
// CMainFrame diagnostics
#ifdef _DEBUG
void CMainFrame::AssertValid() const
{
CFrameWnd::AssertValid();
}
void CMainFrame::Dump(CDumpContext& dc) const
{
CFrameWnd::Dump(dc);
}
#endif //_DEBUG
///////////////////////////////////////////////////////////////
BOOL CMyApp::InitInstance()
{
//在應(yīng)用程序初始化函數(shù)中將程序的主框架隱藏起來;
#ifdef _AFXDLL
Enable3dControls(); // Call this when using MFC in a shared DLL
#else
Enable3dControlsStatic(); // Call this when linking to MFC statically
#endif
SetRegistryKey(_T("Local AppWizard-Generated Applications"));
CMainFrame* pFrame = new CMainFrame;
m_pMainWnd = pFrame;
pFrame->LoadFrame(IDR_MAINFRAME,
WS_OVERLAPPEDWINDOWFWS_ADDTOTITLE, NULL, NULL);
pFrame->ShowWindow(SW_HIDE);
pFrame->UpdateWindow();
return TRUE;
}
四、小結(jié)
托盤程序的信息提示通常是將鼠標光標移到托盤圖標上之后,Windows會發(fā)送消息給托盤程序,從而顯示提示信息--Tooltip。但在Windows XP中我們還看到有些系統(tǒng)托盤程序是自動顯示ToolTips信息的,也就是說不用將鼠標光標移到托盤圖標上便可顯示ToolTips,此類新式的信息提示一般稱為氣球提示,它是由你的程序來控制顯示。氣球提示為托盤程序提供了一種非打擾式的方法通知用戶發(fā)生了某件事情。但是如何讓氣球提示顯示出來呢?其實所有的托盤圖標行為都是通過一個單純的API函數(shù)Shell_NotifyIcon來操作的。你可以利用這個函數(shù)的參數(shù)NOTIFYICONDATA結(jié)構(gòu),這個結(jié)構(gòu)來告訴Windows你想要做什么。下面是這個結(jié)構(gòu)的定義的最新版本(For IE5.0+),其中已經(jīng)加入了新的成員:
typedef struct _NOTIFYICONDATA {
DWORD cbSize;
HWND hWnd;
UINT uID;
UINT uFlags;
UINT uCallbackMessage;
HICON hIcon;
#if (_WIN32_IE < 0x0500)
WCHAR szTip[64];
#else
WCHAR szTip[128];
#endif
#if (_WIN32_IE >= 0x0500)
DWORD dwState;
DWORD dwStateMask;
WCHAR szInfo[256];
union {
UINT uTimeout;
UINT uVersion;
} DUMMYUNIONNAME;
WCHAR szInfoTitle[64];
DWORD dwInfoFlags;
#endif
} NOTIFYICONDATA, *PNOTIFYICONDATA;
在NOTIFYICONDATA.uFlags中的標志之一是NIF_TIP,用它來設(shè)置傳統(tǒng)的信息提示,即鼠標要移動到圖標上。新的標志NIF_INFO(由于_WIN32_IE >= 0x0500條件定義,因此在編譯時,請注意包含最新版本的頭文件shellapi.h,并保證鏈接最新版本的庫文件shell32.lib,分發(fā)程序時用最新版本的運行時動態(tài)鏈接庫shell32.dll)便是為顯示氣球提示所用的。也就是說,要顯示氣球提示,那么在調(diào)用Shell_NotifyIcon函數(shù)時必須用NIF_INFO標志。提示文本填入szInfo域,標題文本填入szInfoTitle。你甚至可以在NOTIFYICONDATA.uTimeout中設(shè)置一個超時時間,當經(jīng)過指定的毫秒數(shù)之后,氣球提示自動隱藏.
歡迎轉(zhuǎn)載,信息來自維庫電子市場網(wǎng)(www.dzsc.com)
來源:ks990次