CSystemTray();
CSystemTray(CWnd* pWnd, UINT uCallbackMessage, LPCTSTR szToolTip, HICON icon, UINT uID);
BOOL Create(CWnd* pWnd, UINT uCallbackMessage, LPCTSTR szToolTip, HICON icon, UINT uID);

Note that the destructor automatically removes the icon from the tray.

pWnd	Window where notification messages will be sent. May be NULL
uCallbackMessage	The notification messages that will be sent to the parent window
szToolTip	Tooltip for the tray icon
icon	Handle to the icon to be displayed
uID	Tray icon

If the pWnd parameter is NULL then the function CSystemTray::OnTrayNotification will be called whenever the icon sends a notification message. See Default message handling for more details.

LRESULT OnTrayNotification(WPARAM wID, LPARAM lEvent) 

void    MoveToRight() 

void    RemoveIcon()

void    HideIcon()

void    ShowIcon() 

BOOL    SetTooltipText(LPCTSTR pszTip) 

BOOL    SetTooltipText(UINT nID) 

CString GetTooltipText() const 

BOOL    SetNotificationWnd(CWnd* pWnd) 

CWnd*   GetNotificationWnd() const 

HICON   GetIcon() const 

BOOL    SetIcon(HICON hIcon) 

BOOL    SetIcon(LPCTSTR lpszIconName) 

BOOL    SetIcon(UINT nIDResource) 

BOOL    SetStandardIcon(LPCTSTR lpIconName) 

BOOL    SetStandardIcon(UINT nIDResource) 

BOOL    SetIconList(UINT uFirstIconID, UINT uLastIconID); 

BOOL    SetIconList(HICON* pHIconList, UINT nNumIcons); 

BOOL    Animate(UINT nDelayMilliSeconds, int nNumSeconds = -1); 

BOOL    StepAnimation(); 

BOOL    StopAnimation();  

BOOL SetMenuDefaultItem(UINT uItem, BOOL bByPos); 

void GetMenuDefaultItem(UINT& uItem, BOOL& bByPos); 

SetStandardIcon can also take any of the following values:

nIDResource             Description                                         
IDI_APPLICATION         Default application icon.
IDI_ASTERISK            Asterisk (used in informative messages).
IDI_EXCLAMATION         Exclamation point (used in warning messages).
IDI_HAND                Hand-shaped icon (used in serious warning messages).
IDI_QUESTION            Question mark (used in prompting messages).
IDI_WINLOGO             Windows logo      

The default CSystemTray message notification handler searches and displays the menu with the same ID as the tray icon. If you use this default handler then you can set the default menu item using SetMenuDefaultItem. The parameters uItem and bByPos are the same as those used in ::SetMenuDefaultItem.

The default menu item code was contributed by Enrico Lelina.

Icon animation

Icon animation can be achieved by specifying a list of icons using SetIconList(...), with either a range of icon resource IDs, or an array of HICONS and the size of the array. Use "Animate(UINT nDelayMilliSeconds, int nNumSeconds)" to start the animation. The first parameter is the delay in milliseconds between displaying each icon in the list, and the second is the number of seconds for which to animate the icons. If -1 is specified then animation will continue until StopAnimation() is called.

Icon animation suggested by Joerg Koenig.

The parent window, on receiving a notification message, can redirect this message back to the tray icon for handling by calling CSystemTray::OnTrayNotification(...). Alternatively, if the CSystemTray object was created with a NULL parent, then this function will be called whenever the icon sends a notification. The default implementation tries to find a menu with the same resource ID as the tray icon. If it finds a menu and the event received was a right mouse button up, then the submenu is displayed as a context menu. If a double click was received, then the message ID of default item in the submenu (set using SetMenuDefaultItem) is sent back to the parent window. If SetMenuDefaultItem has not been called then the default menu item will be the first item in the menu

A good place to declare the tray icon is in your CFrameWnd derived class.
eg.
Add a message map entry for the tray icon notification:
Create the icon (maybe in your OnCreate):
where IDR_POPUP_MENU is the ID of a popup menu to display for the icon. You then need a handler for the tray icon notification message:
The menu used (IDR_POPUP_MENU) looks like the following:

Many people have had troubles using TrackPopupMenu. They have reported that the popup menu will often not disappear once the mouse is clicked outside of the menu, even though they have set the last parameter of TrackPopupMenu() as NULL. This is a Microsoft "feature", and is by design. The mind boggles, doesn't it?

Anyway - to workaround this "feature", one must set the current window as the foreground window before calling TrackPopupMenu. This then causes a second problem - namely that the next time the menu is displayed it displays then immediately disappears. To fix this problem, you must make the currernt application active after the menu disappears. This can be done by sending a benign message such as WM_NULL to the current window.

So - what should have been a simple:
becomes
Refer to KB article "PRB: Menus for Notification Icons Don't Work Correctly" for more info.

개발분류