Placing Your C# Application in the System Tray


There are many cases when it’s advantageous to place an application’s icon in the System Tray.

For example, firewall/antivirus and instant messaging applications do this so as to run in the background and still be accessible to the user without crowding up the task bar.

Here’s a fine .NET Technique that will show us, the steps involved in specifying that an application is to be minimized to the Tray, how to allow the user to restore the application by double-clicking the icon and how to create and respond to a System Tray icon’s context menu.

To get started, open an existing C# Windows form (or create a new one):

  • Open the Visual Studio Toolbox.
  • Drag a NotifyIcon control onto the form. The control will named notifyIcon1 by default and placed below the form because it has no visual representation on the form itself.
  • Set the NotifyIcon control’s Text property to the name you want to appear when the user pauses the mouse over the application’s icon. For example, this value could be “KillerApp 1.0”.
  • Set the control’s Icon property to the icon that you want to appear in the System Tray. Tip: If you have a BMP file that you want to convert to an icon file, you can use the QTam Bitmap to Icon 3.5 application.
  • Add an event handler for the form’s Resize event that will hide the application when it’s minimized. That way, it won’t appear on the task bar.
private void Form1_Resize(object sender, System.EventArgs e)
{
   if (FormWindowState.Minimized == WindowState)
      Hide();
}
  • Add an event handler for the NotifyIcon.DoubleClick event and code it as follows so that the application will be restored when the icon is double-clicked.
private void notifyIcon1_DoubleClick(object sender,
                                     System.EventArgs e)
{
    Show();
    WindowState = FormWindowState.Normal;
}

At this point, your application should function perfectly in terms of an icon appearing in the System Tray when the application is run (see image below), the application not appearing on the task bar when minimized and the application restoring itself when the Tray icon is double-clicked.

1

Now, let’s see the steps involved with adding a context menu to the icon.

  1. From the Visual Studio Toolbox, drag a ContextMenu control onto the form.
  2. Right-click the ContextMenu control and select the Edit Menu.option.
  3. Type in the options that you want to appear in your context menu. For example, you can add options such as Restore and Close Application.
  4. As with any menu, double-click the menu item to create and code each item’s handler. As an example, you could copy the code from the form’s DoubleClick handler into the context menu’sRestore handler and for the Close Application menu item; simply call the form’s Close method.
  5. Finally, set the NotifyIcon control’s ContextMenu property to the new context menu you just created by selecting the menu from the drop-down list. Figure 2 shows a simple Tray context menu.

2

 

🙂

Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s