Getting Started with WinForms Label

This tutorial will help you to quickly get started using the control.

Adding Telerik Assemblies Using NuGet

To use RadLabel when working with NuGet packages, install the Telerik.UI.for.WinForms.AllControls package. The package target framework version may vary.

Read more about NuGet installation in the Install using NuGet Packages article.

With the 2025 Q1 release, the Telerik UI for WinForms has a new licensing mechanism. You can learn more about it here.

Adding Assembly References Manually

When dragging and dropping a control from the Visual Studio (VS) Toolbox onto the Form Designer, VS automatically adds the necessary assemblies. However, if you're adding the control programmatically, you'll need to manually reference the following assemblies:

• Telerik.Licensing.Runtime
• Telerik.WinControls
• Telerik.WinControls.UI
• TelerikCommon

The Telerik UI for WinForms assemblies can be install by using one of the available installation approaches.

Defining the RadLabel

You can add a RadLabel either at design time or at run-time:

Design Time

1. To add a RadLabel to your form, drag a RadLabel from the toolbox onto the surface of the form designer.
2. In the Properties section in Visual Studio change the Text property of RadLabel.
3. Click F5 to start the application.

Run Time

To programmatically add a RadLabel to a form, create a new instance of a RadLabel, and add it to the form`s Controls collection. Change its Text and ForeColor properties.

Adding a RadLabel at Run-time

RadLabel label = new RadLabel();
this.Controls.Add(label);
label.ForeColor = Color.Green;
label.Text = "I am a RadLabel!";

Dim label As New RadLabel()
Me.Controls.Add(label)
label.ForeColor = Color.Green
label.Text = "I am a RadLabel!"

Programming RadLabel

RadLabel shares most of the properties of the standard Windows Form Label, including:

• The BackColor property sets the background color of the control.

• The BackgroundImage and BackgroundImageLayout properties allow you to tile, center, stretch, or zoom an image across the control.

• The ForeColor property sets the color of control`s text.

• The Text property sets the text in the control.

The example below has the BackgroundImage property set to "BlueHills.jpg" (available in the \Samples Pictures directory of many Windows installations) and BackgroundImageLayout set to Stretch. The ForeColor property is set to White.

Figure 1: RadLabel BackgroundImage

See Also

• Design Time
• Structure
• HTML-like Formatting

Telerik UI for WinForms Learning Resources

• Telerik UI for WinForms Label Component
• Getting Started with Telerik UI for WinForms Components
• Telerik UI for WinForms Setup
• Telerik UI for WinForms Application Modernization
• Telerik UI for WinForms Visual Studio Templates
• Deploy Telerik UI for WinForms Applications
• Telerik UI for WinForms Virtual Classroom(Training Courses for Registered Users)
• Telerik UI for WinForms License Agreement)