Once I had written a control panel applet to control my NT Service I though that it might be handy to be able to control the service from an icon in the task tray. Since the result of clicking an icon in the task tray is often similar to running up a control panel applet I hoped to be able to reuse much of my code. The end result was a framework for task bar applets and a derived class that managed control panel applets. I then just let the task bar applet load my control panel applet and provided access to it from the task tray with no code changes required. The resulting classes can load any control panel applet into the task tray, just supply the file name and applet index...
To put an icon in the task tray all an application has to
do is call Shell_NotifyIcon() to supply the icon, tool tip, callback message and a window
to send it to. Making an application that's just a task tray applet is just a case of
creating a hidden window, calling Shell_NotifyIcon() and processing the messages. The
messages are your standard mouse click type messages. It's not that difficult but it takes
a bit of time.
Creating a hidden window with a WndProc that responds to
Task Tray applet messages correctly and does all the right things can be cumbersome if all
you want to do is pop up a dialog box app from the task tray. The framework lets you
derive from an base class that handles all of that stuff for you. All you need to do is
override a few virtual functions and you have a dialog popping up! CJBTaskTrayApplet also
gives you multiple applets in one exe (with multiple separate icons in the task tray) and
automatic right button menu handling.
To implement your task tray applet you need to do the following:
WinMain() implementation.CJBTaskTrayApplet.GetTrayTip() and
GetIcon() to supply the basic require by the framework.OnLeftDoubleClick() to do something when a user
double clicks on you. This is where you would generally show a dialog or something.If you wish you can also:
GetMenu(), HandleMenuCommand() and ReleaseMenu() to
customise the menu you get - By default you get a menu with Close on it in response to
OnRightButtonUp().InitInstance() to allocate resources at start up.OnLeftButtonDown(), OnLeftButtonUp(),
OnRightButtonDown(), OnRightButtonUp(), OnLeftDoubleClick(), OnRightDoubleClick() and
OnMouseMove() to customise your applet's user interface.When I implemented CJBControlPanelApplet I placed multiple applets in a single DLL. After writing much of the same "base class has a static list" code again for the task tray applet I decided to try and create a common base class that incorporated and hid all of the "I'm a class whos instances are in a static list" functionality. It seemed simple enough until I realised that to be type-safe and remove heaps of casts in the derived class the base class needed to know about the derived class. Without a second thought I templatised the base class and had the derived class inherit from it thus:
class CTaskBarApplet : public CLinkedClass<CTaskBarApplet>
Then I thought about it and it seemed like a really odd thing to do. It worked great and gave no warnings but was it nice? Since then I've spoken to several people and read Stroustrup 3e (and he thinks it's a "Good Thing") and now I like the idea. It did seem very odd at first though...
Once I had a standard way to link instances of a class together I needed a way to navigate this list at run-time. After several aborted attempts I ended up with an STL-style iterator. This lets you do things like:
for (Iterator addIt = Begin(); addIt != End(); addIt++) { addIt->AddIcon(); // call any derived class method here }
Of course, having moved the common functionality out into
a base class I never got around to using the base class in
CJBControlPanelApplet,
but I've used it in plenty of other places.
By this stage I had a task tray framework but I still
needed to somehow reuse the code in my control panel applet. Since a .cpl is just a DLL,
and since I'd worked out how CPlApplets worked when I wrote
CJBControlPanelApplet
I decided to write a wrapper class that could load a control panel applet, send it all the
right messages to initialise it and then run the applet. Once I had CJBCPlAppletClient I
derived a CJBCPlTrayApplet from CJBTaskTrayApplet and wired the two together. The end
result was a collaboration something like this:
CJBCPlAppletClient isn't linked in any way to the task
tray classes. It's just used by CJBCPlTrayApplet . It can be used anywhere you want to
access a control panel applet programmatically.
When I started looking at task tray applets I tried to
write one with MFC. I've seen it done but you have to do a fair bit of work to get it to
work right. Message map entries for the callback message, preventing the CWinApp's main
window from popping up briefly, etc, etc. I didn't need MFC so I wrote the straight Win32
solution. Then I wanted a single complex dialog in a task tray applet and I wanted to use
MFC for the dialog and my framework for the applet... It all went well until I ran it and
the dialog died with assertion failures, I didn't have a CWinApp derived class and it was
a serious requirement... Since I didn't have time to convert my applet framework to a
CWinApp derived framework I cheated. Since all that is required is that a CWinApp object
exists so that the dialog has a message pump to use I stuck a vanilla CWinApp object
inside WinMain and called AfxWinInit() directly and everything worked fine...
An #ifdef around this version of WinMain() means that at the flick of a #define
you can have either
MFC enabled or lean and mean versions of your task tray applets.
I really keep meaning to sit down and make CJBTaskTrayApplet a real CWinApp derivative, but, this works...
See article on Len's homepage for the latest updates.
| You must Sign In to use this message board. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
