Balloon Notifications

With the RadNotifyIcon you can show a notification allowing you to display a message or prompt the user for some action.

Balloon Notification Properties

The RadNotifyIcon exposes the following properties for controlling the look of the notification:

• BalloonTitle: Gets or sets the title of the balloon tip.
• BalloonText: Gets or sets the text of the balloon tip.
• BalloonIcon: A property of type System.Drawing.Icon that gets or sets the icon of the balloon tip.

Use an .ico file with bigger dimensions (Width/Height) as Windows can scale it down, however it will not be scaled up, if it is less than the default size.

void ShowBallonNotification()
{
    RadNotifyIcon radNotifyIcon = new RadNotifyIcon();
    radNotifyIcon.TrayIcon = new System.Drawing.Icon("../../WinForms128x28.ico");
    radNotifyIcon.BalloonIcon = new System.Drawing.Icon("../../WinForms128x28.ico");
    radNotifyIcon.ShowTrayIcon = true;
    radNotifyIcon.BalloonText = "Balloon Text";
    radNotifyIcon.BalloonTitle = "Balloon Title";
    radNotifyIcon.ShowBalloonTip();
}

Private Sub ShowBallonNotification()
    Dim radNotifyIcon As RadNotifyIcon = New RadNotifyIcon()
    radNotifyIcon.TrayIcon = New System.Drawing.Icon("../../WinForms128x28.ico")
    radNotifyIcon.BalloonIcon = New System.Drawing.Icon("../../WinForms128x28.ico")
    radNotifyIcon.ShowTrayIcon = True
    radNotifyIcon.BalloonText = "Balloon Text"
    radNotifyIcon.BalloonTitle = "Balloon Title"
    radNotifyIcon.ShowBalloonTip()
End Sub

Figure 1: Balloon Notification

ShowBalloonTip Overloads

Here are the overloads exposed by the ShowBallonTip method:

• void ShowBalloonTip(int timeout = 10): This overload uses the BalloonTitle, BalloonText and the icon provided by BalloonIcon/BalloonIconSource properties to show a notification. Optionally an integer can be passed to specify the amount of seconds to wait before the balloon auto hides (The system minimum and maximum are 10 and 30 seconds).

• void ShowBalloonTip(string title, string text, BalloonTipIcon icon, bool doNotPlaySound = false, int timeout = 10): This overload allows for passing a title, text and choosing an icon from the set of standardized icons. Optionally you can specify whether sound should be played and the amount of seconds to wait before the balloon auto hides (The system minimum and maximum are 10 and 30 seconds).

this.radNotifyIcon.ShowBalloonTip("Warning", "Emergency", BalloonTipIcon.Warning, false, 15);

Me.radNotifyIcon.ShowBalloonTip("Warning", "Emergency", BalloonTipIcon.Warning, False, 15)

Figure 2: Warning Notification

• void ShowBalloonTip(string title, string text, System.Drawing.Icon icon, bool doNotPlaySound = false, int timeout = 10): This overload allows for passing a title, text and a System.Drawing.Icon instance. Optionally you can specify whether sound should be played and the amount of seconds to wait before the balloon auto hides (The system minimum and maximum are 10 and 30 seconds).

var icon = new System.Drawing.Icon("../../WinForms128x28.ico");
this.radNotifyIcon.ShowBalloonTip("Balloon Title", "Balloon Text", icon, false, 15);

Dim icon = New System.Drawing.Icon("../../WinForms128x28.ico")
Me.radNotifyIcon.ShowBalloonTip("Balloon Title", "Balloon Text", icon, False, 15)

Hide the Notification

You can manually hide the notification by invoking the HideBalloonTip method.

this.radNotifyIcon.HideBalloonTip();

Me.radNotifyIcon.HideBalloonTip()