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

NotifyWindow: A different MSN Messenger style notification window

Rate me:
Please Sign up or sign in to vote.
4.85/5 (48 votes)
2 Aug 2004Public Domain2 min read 460.6K   10.2K   213   112
Another MSN Messenger-like notification window, this one does its own drawing

Introduction

NotifyWindow displays an MSN Messenger-like notification window. If you want to display your own images in the notification window, you may prefer to use John O'Byrne's TaskbarNotifer. NotifyWindow may be easier to use if you just intend to display text. Animations are used in opening and closing the NotifyWindow, and the window is displayed TopMost while not stealing focus. The window will be shown for a default of 11 seconds, although this can be changed. NotifyWindow does all of its own drawing, so no extra image files are required.

Using the code

It is pretty simple to display text using NotifyWindow.

C#
// Display the text "This is a sample NotifyWindow"
NotifyWindow nw = new NotifyWindow ("This is a sample NotifyWindow");
nw.Notify();

// The following two lines of code will display a window that 
// looks exactly like the one shown at the beginning of this article.
NotifyWindow nw = new NotifyWindow ("NotifyWindow", 
  "This is a sample notification created with NotifyWindow");
nw.Notify();

If desired, a variety of other options can be changed - such as fonts and colors. The included TestNotifyWindow application will let you play around with a few of the settings, but the code displayed here should serve as a more complete reference.

C#
NotifyWindow nw = new NotifyWindow();

nw.Text = "This is the NotifyWindow text";
nw.Title = "Title Text";

// Change the background style.  Other valid 
// styles are Solid, VerticalGradient,
// HorizontalGradient and BackwardDiagonalGradient  
// (Default: VerticalGradient)
nw.BackgroundStyle = NotifyWindow.BackgroundStyles.ForwardDiagonalGradient;

// Change the background colors  
// (Default: BackColor=SteelBlue, GradientColor=WhiteSmoke)
nw.BackColor = Color.SpringGreen;
nw.GradientColor = Color.White;

// Change the text and title colors.  (Default: ControlText)
nw.TextColor = Color.Blue;
nw.TitleColor = Color.Black;

// Change the color displayed when the text is pressed.  (Default: Gray)
nw.PressedColor = Color.Red;

// Use non-default fonts.  If TitleFont is not set 
// by the user, nw.Font will be used.
nw.Font = new Font ("Tahoma", 8.25F);
nw.TitleFont = new Font ("Tahoma", 8.25F, FontStyle.Bold);

// Change NotifyWindow size.  (Default: 130, 110)
nw.SetDimensions (nwWidth, nwHeight);

// Do not close the NotifyWindow if the mouse 
// cursor is over the window.  (Default: true)
nw.WaitOnMouseOver = true;

// Set up an EventHandler to be called if the text or title are clicked.
nw.TextClicked += new System.EventHandler (nwTextClicked);
nw.TitleClicked += new System.EventHandler (nwTitleClicked);

// Display the window for 20 seconds, or 20000ms.  (Default: 11000ms)
nw.WaitTime = 20000;

// Now show the NotifyWindow.
nw.Notify();

This is how the NotifyWindow created with the above code will look:

Programmers can also use their own Blend (for the background) or StringFormat (which will be used when Text and Title are drawn) if desired by setting the nw.Blend and nw.StringFormat variables.

Points of Interest

NotifyWindow is unique because it does all of its own drawing. The background is drawn using Graphics.FillRectangle with either a LinearGradientBrush (default) or a SolidBrush. The borders are drawn using a series of calls to Graphics.DrawRectangle and Graphics.DrawLine. On Windows XP or higher systems with Visual Styles enabled, the close button is drawn using DrawThemeBackground() from UxTheme.dll - otherwise, ControlPaint.DrawCaptionButton is used.

An obstacle faced in both this and similar applications has been displaying the window on top without stealing focus. Both Form.Show() and setting TopMost = true individually activate the form, which steals focus. We get around this by calling ShowWindow() and SetWindowPos() with arguments instructing the operating system not to activate the window.

C#
const Int32 HWND_TOPMOST = -1;
const Int32 SWP_NOACTIVATE = 0x0010;
const Int32 SW_SHOWNOACTIVATE = 4;
[DllImport ("user32.dll")]
protected static extern bool ShowWindow (IntPtr hWnd, Int32 flags);
[DllImport ("user32.dll")]
protected static extern bool SetWindowPos (IntPtr hWnd, 
  Int32 hWndInsertAfter, Int32 X, Int32 Y, Int32 cx, Int32 cy, uint uFlags);

...

// Show the window without activating it.
ShowWindow (this.Handle, SW_SHOWNOACTIVATE);

// Equivalent to setting TopMost = true, except don't activate the window.
SetWindowPos (this.Handle, HWND_TOPMOST, Left, Top, Width, Height, SWP_NOACTIVATE);

A similar NotifyWindow class was originally implemented for an open-source project called ChronosXP. When it became apparant that others might like to use this code outside of that project, it was modified, removing the ChronosXP-specific parts and making it more generic.

A class called NotifyWindow2000 is included with the distribution that will display the NotifyWindow indefinitely until there is mouse or keyboard activity, similar to balloon windows. It uses SetWindowsHookEx() with WH_KEYBOARD_LL/WH_MOUSE_LL to detect user activity, so it will only work with Windows 2000 or higher. If anyone knows how to do this on older versions of Windows I would like to hear about it.

History

  • Initial coding: July 28, 2004

License

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


Written By
Architect Onestop Internet
United States United States
Web architect and PM, in the E-commerce space.

Comments and Discussions

 
QuestionHow can i just show notification window not form window Pin
name3221-Apr-10 2:56
name3221-Apr-10 2:56 
AnswerRe: How can i just show notification window not form window Pin
Member 114928152-Mar-15 13:33
Member 114928152-Mar-15 13:33 
GeneralQuestion Pin
Benjamin Uboegbu24-Jul-08 6:42
professionalBenjamin Uboegbu24-Jul-08 6:42 
QuestionVB.Net version? Pin
cal1918-Apr-08 2:08
cal1918-Apr-08 2:08 
AnswerRe: VB.Net version? Pin
rzeylah6-Aug-08 0:29
rzeylah6-Aug-08 0:29 
GeneralRe: VB.Net version? Pin
paladinkerb30-Mar-11 9:01
paladinkerb30-Mar-11 9:01 
GeneralUnable to download NotifyWindow Pin
Glauter7-Mar-08 4:12
Glauter7-Mar-08 4:12 
GeneralNotifyWindow on Vista Pin
pogarek15-Feb-07 22:13
pogarek15-Feb-07 22:13 
GeneralRe: NotifyWindow on Vista Pin
Robert Misiak10-Jul-07 8:19
professionalRobert Misiak10-Jul-07 8:19 
QuestionHow to Add a Control Pin
raj_32722-Jan-07 20:30
raj_32722-Jan-07 20:30 
GeneralShow two NotifyWindows above each other Pin
LpH198126-May-06 0:41
LpH198126-May-06 0:41 
GeneralRe: Show two NotifyWindows above each other Pin
ronaldovn17-Mar-10 21:17
ronaldovn17-Mar-10 21:17 
GeneralRe: Show two NotifyWindows above each other Pin
Lucas heezen18-Mar-10 0:59
Lucas heezen18-Mar-10 0:59 
GeneralRe: Show two NotifyWindows above each other Pin
ronaldovn18-Mar-10 16:24
ronaldovn18-Mar-10 16:24 
GeneralRe: Show two NotifyWindows above each other Pin
Dekkie17-Feb-11 4:52
Dekkie17-Feb-11 4:52 
QuestionUsing notify window in a ThreadFunction Pin
jis17-May-06 2:36
jis17-May-06 2:36 
AnswerRe: Using notify window in a ThreadFunction Pin
Robert Misiak17-May-06 3:19
professionalRobert Misiak17-May-06 3:19 
GeneralRe: Using notify window in a ThreadFunction Pin
jis17-May-06 18:41
jis17-May-06 18:41 
GeneralRe: Using notify window in a ThreadFunction Pin
Manjit Sooch20-Jul-06 13:33
Manjit Sooch20-Jul-06 13:33 
GeneralRe: Using notify window in a ThreadFunction Pin
shane198527-Sep-07 9:21
shane198527-Sep-07 9:21 
GeneralRe: Using notify window in a ThreadFunction Pin
lxiongh3-Sep-09 4:03
lxiongh3-Sep-09 4:03 
GeneralRe: Using notify window in a ThreadFunction Pin
LeoLB12-Jun-13 8:10
LeoLB12-Jun-13 8:10 
GeneralRe: Using notify window in a ThreadFunction Pin
EinsteinXXL24-Apr-15 10:43
EinsteinXXL24-Apr-15 10:43 
GeneralStacking windows code Pin
jdmwood29-Mar-06 0:13
jdmwood29-Mar-06 0:13 
GeneralRe: Stacking windows code Pin
jdmwood29-Mar-06 0:16
jdmwood29-Mar-06 0:16 

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.