Click here to Skip to main content
15,867,686 members
Articles / Programming Languages / C#
Article

Creating a Tasktray Application

Rate me:
Please Sign up or sign in to vote.
4.50/5 (38 votes)
23 Sep 2007CPOL2 min read 159.5K   8.5K   127   21
How to create an application that consists primarily of a tasktray icon
Screenshot - TaskTrayApp.png

Introduction

Quite often, people find themselves writing small applications that live mainly in the TaskTray as a TaskTray icon. Something that monitors something, updates something, little applications that run in the background but that they want to let the user know it's running.

To date, the method I've seen all around the Internet to achieve this is to create the configuration form (which in turn contains the NotifyIcon) and then hide the configuration form.

This, however, has several drawbacks, the main one being that the configuration form will flicker whenever you start the application. Getting it to start hidden can be a bit of a chore.

Fortunately, there is a better way to start an application as a NotifyIcon: using ApplicationContext.

Using the Code

Start by creating a WinForms project and editing the configuration form to suit your needs. Once you have done this, open up Program.cs. You should find that the last line looks like this:

C#
Application.Run(new Form1());

This tells the Application to load and show Form1, and to keep the Application alive as long as Form1 is alive. But take a look at the overloads for Run. Not only does it accept Forms, but also ApplicationContexts.

Create a new class that inherits from ApplicationContext (we will refer to it as MyApplicationContext). Then replace the above line with:

C#
Application.Run(new MyApplicationContext());

Inside the constructor for MyApplicationContex, you can insert the code to initialize the NotifyIcon. Mine looks something like this:

C#
MenuItem configMenuItem = new MenuItem("Configuration", new EventHandler(ShowConfig));
MenuItem exitMenuItem = new MenuItem("Exit", new EventHandler(Exit));

NotifyIcon notifyIcon = new NotifyIcon();
notifyIcon.Icon = TaskTrayApplication.Properties.Resources.AppIcon;
notifyIcon.ContextMenu = new ContextMenu(new MenuItem[] 
    { configMenuItem, exitMenuItem });
notifyIcon.Visible = true;

You can then create a ShowConfig method to display the configuration window. Mine looks something like this:

C#
Configuration configWindow = new Configuration();
void ShowConfig(object sender, EventArgs e)
{
    // If we are already showing the window, merely focus it.
    if (configWindow.Visible)
    {
        configWindow.Activate();
    }
    else
    {
        configWindow.ShowDialog();
    }
}

And for completeness, my Exit method looks like this:

C#
void Exit(object sender, EventArgs e)
{
    // We must manually tidy up and remove the icon before we exit.
    // Otherwise it will be left behind until the user mouses over.
    notifyIcon.Visible = false;
    Application.Exit();
}

So you should now be able to create applications that start, live and die in the TaskTray without having to hack together a form to host the NotifyIcon.

History

  • 07/05/2007
    • Submitted article
  • 09/23/2007
    • Fixed formatting
    • Changed configWindow.Focus(); to configWindow.Activate();

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
United Kingdom United Kingdom
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
QuestionVery nice, but can I start a message-loop without any forms? Pin
david zha020-May-07 19:46
david zha020-May-07 19:46 
AnswerRe: Very nice, but can I start a message-loop without any forms? Pin
[ICR]20-May-07 22:52
[ICR]20-May-07 22:52 
AnswerRe: Very nice, but can I start a message-loop without any forms? Pin
david zha021-May-07 1:08
david zha021-May-07 1:08 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.