Click here to Skip to main content
13,139,773 members (44,349 online)
Click here to Skip to main content
Add your own
alternative version


118 bookmarked
Posted 26 Apr 2010

Create a System Tray Application in VB.NET

, 4 May 2010
Rate this:
Please Sign up or sign in to vote.
Write an application that launches in the notification area.



This article was prompted by a question in Quick Answers about how to write a VB.NET application that started in the tray. There were a number of examples here at CodeProject -- this article[^] by member [ICR] in particular -- but I could not find anything in VB. This article is meant to remedy that situation.

The Theory

As C# programmers know, applications start with a call to System.Windows.Forms.Application.Run. This call is normally hidden from VB.NET programmers, with the compiler supplying the required code behind the scenes. We can call this explicitly, however, which allows us to write applications that do not rely on start-up forms.

AppContext Class

The first step is to create a class that inherits from System.Windows.Forms.ApplicationContext. This provides the information needed by the Operating System to manage your application. This is also where you instantiate your NotifyIcon for the system tray, a menu to interact with the icon and any other essentials.

Public Class AppContext
    Inherits ApplicationContext

#Region " Storage "
    Private WithEvents Tray As NotifyIcon
    Private WithEvents MainMenu As ContextMenuStrip
    Private WithEvents mnuDisplayForm As ToolStripMenuItem
    Private WithEvents mnuSep1 As ToolStripSeparator
    Private WithEvents mnuExit As ToolStripMenuItem

#End Region

#Region " Constructor "
    Public Sub New()
        'Initialize the menus
        mnuDisplayForm = New ToolStripMenuItem("Display form")
        mnuSep1 = New ToolStripSeparator()
        mnuExit = New ToolStripMenuItem("Exit")
        MainMenu = New ContextMenuStrip
        MainMenu.Items.AddRange(New ToolStripItem() {mnuDisplayForm, mnuSep1, mnuExit})

        'Initialize the tray
        Tray = New NotifyIcon
        Tray.Icon = My.Resources.TrayIcon
        Tray.ContextMenuStrip = MainMenu
        Tray.Text = "Formless tray application"

        Tray.Visible = True
    End Sub

#End Region

#Region " Event handlers "
    Private Sub AppContext_ThreadExit(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.ThreadExit
        'Guarantees that the icon will not linger.
        Tray.Visible = False
    End Sub

    Private Sub mnuDisplayForm_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles mnuDisplayForm.Click
    End Sub

    Private Sub mnuExit_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles mnuExit.Click
    End Sub

    Private Sub Tray_DoubleClick(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Tray.DoubleClick
    End Sub

#End Region

End Class

This is pretty straightforward. The icon and menus are initialized in the class' Sub New, and the icon is made visible. The ThreadExit is where you clean up objects created within the class. The class also handles the Click event for mnuDisplay, which displays a dialog form, and mnuExit, which closes the application. Double clicking on the icon has the same effect as clicking mnuDisplay.

OtherMethods Module

I put the methods ExitApplication and ShowDialog in a separate code file.

Friend Module OtherMethods

    Private PF As PopupForm

    Public Sub ExitApplication()
        'Perform any clean-up here
        'Then exit the application
    End Sub

    Public Sub ShowDialog()
        If PF IsNot Nothing AndAlso Not PF.IsDisposed Then Exit Sub

        Dim CloseApp As Boolean = False

        PF = New PopupForm
        CloseApp = (PF.DialogResult = DialogResult.Abort)
        PF = Nothing

        If CloseApp Then ExitApplication
    End Sub

End Module

The module is tagged as Friend to prevent it from being exported. ExitApplication is where you would clean up any objects that are external to AppContext. Your application shuts down with the call to Application.Exit, which triggers AppContext's ThreadExit event. If you have any open forms, Application.Exit will close those down, exactly as you would expect.


ShowDialog displays a simple dialog box that allows the user to either cancel the form or close the application. I had to do a bit of extra work to guarantee that one and only one dialog box gets displayed: clicking mnuDisplayForm will happily spawn multiple forms otherwise.

Main Method

The next step is to write the code that launches your application. In a public module, declare one of four variations of the Main method.

Public Module LaunchApp

    'Version 1
    Public Sub Main()
        Application.Run(New AppContext)
    End Sub

    'Version 2
    'Public Sub Main(ByVal cmdArgs() As String)
    'End Sub

    'Version 3
    'Public Function Main() As Integer
    'End Function

    'Version 4
    'Public Function Main(ByVal cmdArgs() As String) As Integer
    'End Function

End Module

In most cases, version 1 will be sufficient. If you need access to the command line, then you will want to use version 2. Versions 3 and 4 allow you to return an integer value to the Operating System when your application closes, which is useful only in rare situations.

The call to Application.Run is the key here. There are three overloads: instead of an ApplicationContext, you can also pass a Form object or no parameter. The no parameter version creates a default context which is useful for console applications. The Form version is what VB normally uses internally. You can conditionally call different versions of Application.Run, like so:

Public Sub Main(ByVal cmdArgs() As String)

    Dim UseTray As Boolean = False

    For Each Cmd As String In cmdArgs
        If Cmd.ToLower = "-tray" Then
            UseTray = True
            Exit For
        End If

    If UseTray Then
        Application.Run(New AppContext)
        Application.Run(New MainForm)
    End If
End Sub

With this, you can use a command line switch to decide whether your app will launch with a main form or into the notification area.

Note that the first line of code is Application.EnableVisualStyles. For reasons explained below, it is necessary to turn visual styles off when configuring your project; this is where you turn them back on. You don't have to do this, of course, but if your app has any interface elements, they will look nicer if you do.

My Project

The last step is to configure your project to use the Main method. Start by pulling up the My Project interface. On the Application tab, uncheck the "Enable application framework" box. This disables various application framework properties, including the XP visual styles (which is why we need to turn them back on). Now, go to the "Startup object" drop-down and select Sub Main. Be aware that you will select Sub Main even if you are using one of the Function Main methods.

When you run your application, the bootstrap will now call Main. Your custom context class will be launched, which sets up an interactive icon in the notification area.


I hope you found this article useful; if so, please vote it up. And if you find any bugs, please let me know below and I will try to get them fixed.


  • Version 4 - May 4, 2010 - Clarified a few points, fixed some grammar, and changed references to "tray" into either "notification area" (the official name) or "system tray" (which Microsoft says is wrong, but still uses in its own documentation). My apologies for the naming confusion.
  • Version 2, 3 - April 26, 2010 - Initial release.


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


About the Author

Gregory Gadow
Software Developer (Senior)
United States United States
Gregory Gadow is currently a student at Central Washington University, studying for a B.S. in Actuarial Science with plans to graduate in June, 2019. He has been writing code for almost 30 years in more than a dozen programming languages. Previously, he worked for a mid-size brokerage firm as the company's programming department doing VB6, VB.Net, ASP, HTML, XML and SQL. He also held the Series 7 and Series 66 brokerage licenses.

You may also be interested in...


Comments and Discussions

QuestionShow a balloon tip Pin
stepef11-Feb-13 23:41
memberstepef11-Feb-13 23:41 
AnswerRe: Show a balloon tip Pin
Gregory.Gadow12-Feb-13 3:53
memberGregory.Gadow12-Feb-13 3:53 
GeneralRe: Show a balloon tip Pin
stepef12-Feb-13 4:06
memberstepef12-Feb-13 4:06 
QuestionIcon not clearing Pin
Rodney Buxton14-Nov-12 2:58
memberRodney Buxton14-Nov-12 2:58 
AnswerRe: Icon not clearing Pin
Gregory.Gadow12-Feb-13 3:56
memberGregory.Gadow12-Feb-13 3:56 
GeneralMy vote of 5 Pin
Polinia5-Oct-12 2:34
memberPolinia5-Oct-12 2:34 
GeneralMy vote of 5 Pin
Samoxin26-Sep-12 12:28
memberSamoxin26-Sep-12 12:28 
GeneralMy vote of 5 Pin
WillB121-Sep-12 18:05
memberWillB121-Sep-12 18:05 
Exactly what I was looking for in a VB environment!
Questioni think its what im looking for Pin
Ricardo Martins8-Jul-12 2:04
memberRicardo Martins8-Jul-12 2:04 
AnswerRe: i think its what im looking for Pin
Gregory.Gadow10-Jul-12 3:25
memberGregory.Gadow10-Jul-12 3:25 
GeneralRe: i think its what im looking for Pin
Ricardo Martins14-Aug-12 4:51
memberRicardo Martins14-Aug-12 4:51 
GeneralMy vote of 5 Pin
bryanmajury16-May-12 23:42
memberbryanmajury16-May-12 23:42 
GeneralThanks ... great stuff Pin
chuck crego23-Apr-12 7:54
memberchuck crego23-Apr-12 7:54 
QuestionForm Controls Pin
Member 87185042-Apr-12 6:19
memberMember 87185042-Apr-12 6:19 
QuestionAdd icons (images) to SubMenuItems Pin
Rosstarr1-Apr-12 23:56
memberRosstarr1-Apr-12 23:56 
AnswerRe: Add icons (images) to SubMenuItems Pin
Gregory.Gadow2-Apr-12 2:25
memberGregory.Gadow2-Apr-12 2:25 
AnswerRe: Add icons (images) to SubMenuItems Pin
Zac Greve23-Jun-12 16:31
memberZac Greve23-Jun-12 16:31 
QuestionCode Conversion Pin
Member 871850411-Mar-12 3:59
memberMember 871850411-Mar-12 3:59 
AnswerRe: Code Conversion Pin
Gregory.Gadow11-Mar-12 15:57
memberGregory.Gadow11-Mar-12 15:57 
QuestionRe: Code Conversion Pin
Member 871850412-Mar-12 6:59
memberMember 871850412-Mar-12 6:59 
AnswerRe: Code Conversion Pin
Gregory.Gadow12-Mar-12 9:41
memberGregory.Gadow12-Mar-12 9:41 
GeneralRe: Code Conversion Pin
Member 871850412-Mar-12 9:59
memberMember 871850412-Mar-12 9:59 
Questionusing classes Pin
Xaviersmork3-Mar-12 13:00
memberXaviersmork3-Mar-12 13:00 
AnswerRe: using classes Pin
Xaviersmork3-Mar-12 13:02
memberXaviersmork3-Mar-12 13:02 
GeneralMy vote of 5 Pin
manoj kumar choubey26-Feb-12 18:21
membermanoj kumar choubey26-Feb-12 18:21 

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.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.170915.1 | Last Updated 4 May 2010
Article Copyright 2010 by Gregory Gadow
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid