Click here to Skip to main content
14,149,668 members
Click here to Skip to main content
Add your own
alternative version


89 bookmarked
Posted 13 Mar 2005
Licenced Public Domain

Automatic Application Wait Cursor

, 16 Mar 2005
Rate this:
Please Sign up or sign in to vote.
Use this library to very easily add an application wide WaitCursor whenever your application is working.

Sample Screen Shot from Demo


Making your WinForm applications User Friendly is important. One aspect of a good user experience is informing your user that your application is unresponsive during short periods of work. This article introduces an effective and simple way of adding application wide WaitCursors using one line of start-up code.


Recently, I have been working on a WinForms project at home that occasionally performs some short (less than 5 seconds) running tasks. I wanted the user to be informed that during that short period the UI is unresponsive, so I chose to use the Cursors.WaitCursor to indicate this. This article shows how I came to my final WaitCursor library implementation which I believe is a completely re-usable library.

Using the code

From a developer's point of view, using the WaitCursor library could not get any simpler. Add a reference to the WaitCursor assembly and then add the following line to your application start-up code:

ApplicationWaitCursor.Cursor = Cursors.WaitCursor;

That’s it!

You can of course use any Cursor you like, you can use one of the predefined Cursors or you can create a new cursor and use that instead. You can also fine tune the amount of work time that will elapse before the Cursor is shown:

ApplicationWaitCursor.Delay = 
             new TimeSpan(0, 0, 0, 1, 0);  // Delay of 1 second

How the library came about

During development of a recent WinForms project at home, I had decided to use the cursor to indicate short running tasks to the user, like so:

private void DoShortRunningTask()
    Cursor.Current = Cursors.WaitCursor; 

    .. do some work .. 

    Cursor.Current = Cursors.Default; 

Now, before you say "Where’s the exception handling code?", I am trying to illustrate how I eventually came to my final cut of the WaitCursor library.

The above code works, or, at least it works most of the time. I, of course, found that without any exception handling I could end up with the WaitCursor on permanently, so I quickly came up with:

private void DoShortRunningTask()
  Cursor.Current = Cursors.WaitCursor;
    .. do some work ..
    Cursor.Current = Cursors.Default;

Now that’s better, I've guaranteed that the Cursor will always be returned to the Default cursor even if an exception occurs. However, I found it arduous to wrap that code around every short running task that I was developing.

Then I remembered how I used to use C++ stack based destructors to perform tear down work upon exiting of a method:

void DoShortRunningTask()
StWaitCursor cursor = new StWaitCursor();

  .. do some work .. 
// Implicitly called ~StWaitCursor returns the Cursor to Default


But I couldn't use C# destructors the same way since you can't guarantee when a C# destructor is called since the Garbage Collector thread is responsible for that.

Instead, C# uses a different language feature, the using statement which implicitly calls the Dispose method of objects that implement IDisposable. Although (I find it's) not quite as easy to use as the C++ destructor, you can achieve the same result with the using statement:

private void DoShortRunningTask()
    using (new StWaitCursor())
        .. do some work .. 

This code, of course, requires the StWaitCursor class:

public class StWaitCursor : IDisposable
  public StWaitCursor()
    Cursor.Current = Cursors.WaitCursor;
  public void Dispose()
    Cursor.Current = Cursors.Default;

There, nice and simple. I found, however, that if my short running task was too short then the user sees a quick flickering of the Cursor to and from the WaitCursor, quite annoying. So I decided I needed a way of turning the WaitCursor on after a predefined amount of time during a task.

After quite a few iterations and refactorings, I came up with what I called the StDelayedCallback class (see source code) which is a generic class that once instantiated will wait for a specified amount of time before calling the Start method of an IDelayedCallbackHandler, and if Start was called that it was guaranteed to call the Finish method of the same interface. Once I had this, I could easily implement the interface such that the WaitCursor was turned on when Start was called and returned the Default cursor when Finish was called.

Some things I found

During development of the WaitCursor library, I discovered that I could not set Cursor.Current on any thread other than the GUI thread. This is where the Win32 AttachThreadInput method can be used to get around this problem effectively. So I developed the StThreadAttachedDelayedCallback class which wraps up the call to the AttachThreadInput.

So eventually I ended up with a generic StDelayedCallback class, a ThreadInput attached version of it called StThreadAttachedDelayedCallback and a specific Cursor implementation called StWaitCursor. Incidentally, I used the prefix St since I had originally intended on using these classes in a similar way to the C++ Stack based classes I had used in the past. So up until now, I had intended on using the following:

private void DoShortRunningTask()
  using (new StWaitCursor(new TimeSpan(0, 0, 0, 0, 500))
    .. do some work ..

However, it still meant I had to be explicit about where I wanted my WaitCursor to show.

Then I had an attack of brilliance and came up with the ApplicationWaitCursor singleton class which neatly wraps the StWaitCursor such that whenever the application is working, or rather, whenever it’s not regularly calling OnApplicationIdle, then the StWaitCursor kicks in and shows the WaitCursor.

The only caveat I found was when I dragged a window around which blocks the OnApplicationIdle call. So, I also intercept the WM_NCLBUTTONDOWN message (which is sent at the beginning of the window dragging) to temporarily disable the StWaitCursor.

That's where I am up to with the current WaitCursor implementation and in brief how I got there. You can easily derive from the StDelayedCallback class to create similar effects. Perhaps you would like to show an Indefinite progress bar during your long running tasks, or indicate "Saving Changes..." in a StatusBar control:

private void SaveChanges()
  using (new StStatusBar(stbMain, "Saving Changes...")
    .. do some work ..
  // StStatusBar.IDispose could return the Text
  // of the StatusBar to its original value 

Note that the source code does not contain the StStatusBar class, I am just using it as an example of other ways you could use the StDelayedCallback class.


Version (12th March 2005)

  • Initial version.

Version (16th March 2005)

  • Updated to be CLS compliant (thanks to C a r l and Mathew Hall for pointing this out).


This article, along with any associated source code and files, is licensed under A Public Domain dedication


About the Author

Steve Fillingham
Web Developer
Australia Australia
I am a .NET Developer living in Melbourne, Australia. I am happily married with 2 gorgeous little girls, Georgia and Maddison.

You may also be interested in...


Comments and Discussions

AnswerRe: What version of the .NET Framework has this been tested on? Pin
QStarin9-Jul-08 6:50
memberQStarin9-Jul-08 6:50 
GeneralRe: What version of the .NET Framework has this been tested on? Pin
Steve Fillingham11-Jul-08 15:44
memberSteve Fillingham11-Jul-08 15:44 
Generalvery good. Pin
ali_reza_zareian17-Apr-08 0:43
memberali_reza_zareian17-Apr-08 0:43 
GeneralBeyond what I needed Pin
Chris Maunder16-Apr-08 2:11
adminChris Maunder16-Apr-08 2:11 
GeneralGreat work this was just what i was looking for Pin
gshea1-Dec-07 3:39
membergshea1-Dec-07 3:39 
GeneralThanks Pin
mark.deraeve10-Oct-07 21:12
membermark.deraeve10-Oct-07 21:12 
GeneralRe: Thanks Pin
mark.deraeve11-Oct-07 1:53
membermark.deraeve11-Oct-07 1:53 
GeneralThanks! Awesome idea!! Pin
Bit-Smacker31-Aug-07 10:05
memberBit-Smacker31-Aug-07 10:05 
You saved me lots of irritation from having to manage my own cursor changes!

I copied the two setup lines from your example into my app. and deleted about 20 lines of my cursor changes. It now works much better than my original code ever did!!

This should be a standard .NET control in the Windows Forms tool collection!
GeneralSo sweet, I call it ninja-code! Pin
Brad_Isbell27-Oct-06 12:26
memberBrad_Isbell27-Oct-06 12:26 
GeneralMinor Issue Pin
secovel22-May-06 3:18
membersecovel22-May-06 3:18 
GeneralRe: Minor Issue Pin
Steve Fillingham23-May-06 1:22
memberSteve Fillingham23-May-06 1:22 
GeneralBrilliant - thanks! Pin
seankearon4-Apr-06 14:27
memberseankearon4-Apr-06 14:27 
GeneralRe: Brilliant - thanks! Pin
Steve Fillingham6-Apr-06 0:25
memberSteve Fillingham6-Apr-06 0:25 
QuestionStStatusbar? Pin
RK KL18-Aug-05 11:49
memberRK KL18-Aug-05 11:49 
AnswerRe: StStatusbar? Pin
Steve Fillingham19-Aug-05 2:02
memberSteve Fillingham19-Aug-05 2:02 
GeneralInteresting, but has a few little bugs... Pin
spam2@vbusers.com12-Aug-05 6:05
memberspam2@vbusers.com12-Aug-05 6:05 
GeneralVery good job. Pin
RK KL11-Aug-05 12:35
memberRK KL11-Aug-05 12:35 
QuestionAm I missing anything? Pin
Yaron Shkop6-Jun-05 1:36
memberYaron Shkop6-Jun-05 1:36 
AnswerRe: Am I missing anything? Pin
Steve Fillingham6-Jun-05 4:30
memberSteve Fillingham6-Jun-05 4:30 
GeneralRe: Am I missing anything? Pin
Yaron Sh14-Jun-05 0:15
memberYaron Sh14-Jun-05 0:15 
GeneralRe: Am I missing anything? Pin
Steve Fillingham14-Jun-05 4:07
memberSteve Fillingham14-Jun-05 4:07 
GeneralA little bug Pin
Nikolyv24-May-05 21:25
memberNikolyv24-May-05 21:25 
GeneralSeparate thread Pin
namsaray21-Apr-05 8:10
membernamsaray21-Apr-05 8:10 
GeneralVB version Pin
marcrobitaille29-Mar-05 3:01
membermarcrobitaille29-Mar-05 3:01 
GeneralRe: VB version Pin
marcrobitaille30-Mar-05 4:18
membermarcrobitaille30-Mar-05 4:18 

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 | Cookies | Terms of Use | Mobile
Web04 | 2.8.190518.1 | Last Updated 16 Mar 2005
Article Copyright 2005 by Steve Fillingham
Everything else Copyright © CodeProject, 1999-2019
Layout: fixed | fluid