The Ultimate Toolbox Task Bar Icon

• Download demo executable - 153.6 KB

• Download the Ultimate Toolbox source code - 3 MB
• Download the Ultimate Toolbox sample projects - 5.4 MB
• Download the Ultimate Toolbox documentation in compiled HTML help (CHM) format - 4.9 MB

Visit the Ultimate Toolbox main page for an overview and configuration guide to the Ultimate Toolbox library.

Source code and project files for this sample can be found in the samples\gui\TaskBarIcon directory of the sample projects download.

Overview

The COXTaskbarIcon class encapsulates the Win32 API's Shell_NotifyIcon() function to let you easily show, hide, or change icons in Window 95's or Windows NT's taskbar notification area. It is derived from the MFC class CWnd, therefore you can derive a class from it to handle mouse messages (thus hiding codes for taskbar icons from those in your main program). Yet, it doesn't abolish the convenience of handling mouse messages within your CWnd classes, because you can always tell it to route those messages to another CWnd object even at run-time.

Features

• COXTaskbarIcon is derived from CWnd;
• easy to show, hide or change a taskbar icon;
• easy to set or change the tooltip text of a taskbar icon at run-time;
• easy to handle the mouse messages from taskbar icons, either within a derived class from COXTaskbarIcon, or within your CWnd classes.

Usage

You can use the COXTaskBarIcon icon class directly or through a derived class that can handle timer, mouse, etc. notifications directly just by declaring an instance in your application, setting an icon image, and calling the Show method.

This code is from the CTaskBarDlg class's constructor (from the taskbar sample shown):

    m_TaskbarIcon.Create();
    // When there is only one taskbar icon, you don't need to specify an ID.


    // The ID is useful only when implementing two (or more) taskbar icons, 


    // AND you want to handle mouse messages from both icons within one 


    // message handler (therefore, you need that ID to tell which icon posted 


    // the msg). However, it might be a good idea to assign an ID, and check 


    // the ID in the message handler, especially when you may need


    // to derive your classes (somebody else may add another taskbar icon).



    // Note: you don't need to destroy a taskbar icon. It's done in its own 


    // destructor.



    m_TaskbarIcon.m_pPopupOwner = this;
    // let this dialog handle popup menu's message


    // Note: m_pPopupOwner is NOT a member of COXTaskbarIcon. This is for the 


    // demo's derived taskbar only.

From here, in the sample, the task bar icon is shown or hidden and it's various aspects set at runtime in response to user interaction with the dialog, but could just as easily be setup for the duration of the application in OnInitDialog.

A complete class reference for the COXTaskBarIcon class is available in the compiled HTML help documentation.

History

Initial CodeProject release August 2007.