# 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.



> 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.

```C#
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();
}
```

```VB.NET
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**

![Balloon Notification](https://www.telerik.com/products/winforms/documentation/assets/75de10f18c0f831aa3fae69c009181ae/radnotifyicon-features-balloon-notifications001.png)

## 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).

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

```VB.NET
radNotifyIcon.ShowBalloonTip("Warning", "Emergency", BalloonTipIcon.Warning, False, 15)
```

#### **Figure 2: Warning Notification**

![Warning Notification](https://www.telerik.com/products/winforms/documentation/assets/daa3d2300a45b442b2f132e2eba0ccfb/radnotifyicon-features-balloon-notifications002.png)

* **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).

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

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

## Hide the Notification

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

```C#
this.radNotifyIcon.HideBalloonTip();
```

```VB.NET
radNotifyIcon.HideBalloonTip()
```