 |
Desktop Development »
Shell and IE programming »
General
Intermediate
Easy Animated Tray IconBy Steve SchanevilleThis is a class (SS_TrayIcon) that allows for the easy addition of a tray icon into any project (whether you use MFC or not). |
VC6, VC7Win2K, Dev
|
|
Advanced Search Add to IE Search |
|
|
|
||||||||||||||||
SS_TrayIcon) that creates a tray icon in the system tray,
allowing easy integration into any project, whether or not you use MFC. Some
of the features include:
CWnd::WindowProc function. WM_LBUTTONDOWN Windows message before a user
double-clicks. This is a common problem... when the user double-clicks,
programs often process a single-click before processing the double-click.
This class will wait to send the single-click message until it is sure that the
user won't double-click. (note: this feature does not work if you let
MFC handle the message routing.)This class is similar to Chris Maunder's class in Adding
Icons to the System Tray except that it allows you to specify the mode (SSTI_MODE_SHOWNORMAL,
SSTI_MODE_HIDE, SSTI_MODE_BLINK, SSTI_MODE_ANIMATE)
A simple demo project is included:
SS_TrayIcon* m_pTrayIcon = new SS_TrayIcon( m_hInstance, 1, 1 ); // create the instance m_pTrayIcon->LoadIcon( 0, 0, IDI_SOME_ICON_RESOURCE ); // load an icon resource m_pTrayIcon->ShowIcon( 0 ); // show it!Some other options include:
m_pTrayIcon->Mode( 0, SSTI_MODE_BLINK ); // make it blink m_pTrayIcon->SetAnimateSpeed( 0, 400 ); // 400 is milliseconds m_pTrayIcon->ToolTip( 0, _T("This is a blinking icon...") ); // add a tool tip m_pTrayIcon->ShowMenuAtMouse( nMenuResourceID, hWnd ); // show a popup menu m_pTrayIcon->HideIcon(); // hide it!Most of the functions that alter the icon require an integer as the first parameter (
nIconSet). Because you can have multiple icons, this integer specifies which icon
you want to alter. Then when you show the icon, you specify which icon you want
to show. From here on out, we will refer to each one of these icons as an IconSet...
here's why: each IconSet can contain multiple "sub-icons", which we will refer to
as "frames". So each IconSet makes up an animation that is composed of some number
of frames. You can load icon resources into the frames of your IconSets as in the
following code, which creates 3 IconSets, one with 8 frames, and two with only 1 frame:
// How many icons (IconSets)?
// | How many icons per set (frames)?
// | |
m_pTrayIcon = new SS_TrayIcon( AfxGetInstanceHandle(), 3, 8 );
// prep IconSet 1 (animated with 8 frames)
//
// This is which IconSet to load into...
// | This is the frame number...
// | |
m_pTrayIcon->LoadIcon( 0, 0, IDI_ICON1 );
m_pTrayIcon->LoadIcon( 0, 1, IDI_ICON2 );
m_pTrayIcon->LoadIcon( 0, 2, IDI_ICON3 );
m_pTrayIcon->LoadIcon( 0, 3, IDI_ICON4 );
m_pTrayIcon->LoadIcon( 0, 4, IDI_ICON5 );
m_pTrayIcon->LoadIcon( 0, 5, IDI_ICON4 );
m_pTrayIcon->LoadIcon( 0, 6, IDI_ICON3 );
m_pTrayIcon->LoadIcon( 0, 7, IDI_ICON2 );
m_pTrayIcon->Mode( 0, SSTI_MODE_ANIMATE );
m_pTrayIcon->SetAnimateSpeed( 0, 150 );
m_pTrayIcon->ToolTip( 0, _T("This is an animated icon...") );
// prep IconSet 2 (blinking)
//
m_pTrayIcon->LoadIcon( 1, 0, IDR_MAINFRAME );
m_pTrayIcon->Mode( 1, SSTI_MODE_BLINK );
m_pTrayIcon->SetAnimateSpeed( 0, 450 );
m_pTrayIcon->ToolTip( 1, _T("This is a blinking icon...") );
// prep IconSet 3 (standing still)
//
m_pTrayIcon->LoadIcon( 2, 0, IDI_ICON6 );
m_pTrayIcon->Mode( 2, SSTI_MODE_SHOWNORMAL );
m_pTrayIcon->ToolTip( 2, _T("This is a non-animated icon...") );
// Now show the first (animated) icon
//
m_pTrayIcon->ShowIcon( 0 ); // or '1' for the second, or '2' for the third
The last thing you need to know is about the message map. For each message you
want to respond to, you need the call the m_pTrayIcon->MapMessageToFunction
function. You need to supply the function with a pointer to your global callback
function so it can call that function when the message is generated, as so:
// *global* callback function for the WM_LBUTTONDBLCLK message LRESULT CALLBACK OnMouseDblClickTI(WPARAM wParam, LPARAM lParam) { ::MessageBox(NULL, _T("Double-clicked!!"), _T("Test"), MB_OK|MB_ICONINFORMATION); return 0; } // in your initialization routine CYourClass::InitObject() { ... m_pTrayIcon = new SS_TrayIcon( AfxGetInstanceHandle(), 3, 8 ); m_pTrayIcon->MapMessageToFunction(WM_LBUTTONDBLCLK, ::OnMouseDblClickTI); ... }Now whenever the user double-clicks on the tray icon (no matter which one you have showing), your
OnMouseDblClickTI() function will be called. You can do anything
you want from there. If you want to respond differently depending on which icon you
have showing, you will have to keep track of which icon is showing and use a switch
in the callback function to determine what action is appropriate.
SS_TrayIcon class, and
there are also lots of comments in the SS_TrayIcon code explaining how the code works, so
please read through those comments for a much more detailed explanation of the inner workings
of this project.
General 
News 
Question 
Answer 
Joke 
Rant 
Admin
|
PermaLink |
Privacy |
Terms of Use
Last Updated: 4 Feb 2002 Editor: Chris Maunder |
Copyright 2002 by Steve Schaneville Everything else Copyright © CodeProject, 1999-2009 Web18 | Advertise on the Code Project |
