New to Telerik UI for WinForms? Download free 30-day trial

Getting Started with WinForms TreeMap

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

Adding Telerik Assemblies Using NuGet

To use RadTreeMap 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 RadTreeMap

This article shows how you can start using RadTreeMap. Just drag a RadTreeMap from the toolbox and drop it onto the form. Then, define the sample data in a DataTable and bind the control:

RadTreeMap is supported in .NET Framework 4.0 (or higher).

WinForms RadTreeMap Getting Started


DataTable dt = new DataTable();
dt.Columns.Add("Country", typeof(string));
dt.Columns.Add("Population", typeof(float));
dt.Columns.Add("Continent", typeof(string));

dt.Rows.Add("Italy", 59.55f, "Europe");
dt.Rows.Add("France", 67.39f, "Europe");
dt.Rows.Add("Germany", 83.24f, "Europe");
dt.Rows.Add("Spain", 47.35f, "Europe");
dt.Rows.Add("Bulgaria", 6.9f, "Europe");


dt.Rows.Add("Egypt", 102.3f, "Africa");
dt.Rows.Add("Marocco", 36.9f, "Africa");
dt.Rows.Add("Kenia", 53.77f, "Africa");
dt.Rows.Add("Mali", 20.25f, "Africa");

this.radTreeMap1.DisplayMember = "Country";
this.radTreeMap1.ValueMember = "Population";
this.radTreeMap1.DataSource = dt;


Dim dt As DataTable = New DataTable()
dt.Columns.Add("Country", GetType(String))
dt.Columns.Add("Population", GetType(Single))
dt.Columns.Add("Continent", GetType(String))

dt.Rows.Add("Italy", 59.55F, "Europe")
dt.Rows.Add("France", 67.39F, "Europe")
dt.Rows.Add("Germany", 83.24F, "Europe")
dt.Rows.Add("Spain", 47.35F, "Europe")
dt.Rows.Add("Bulgaria", 6.9F, "Europe")

dt.Rows.Add("Egypt", 102.3F, "Africa")
dt.Rows.Add("Marocco", 36.9F, "Africa")
dt.Rows.Add("Kenia", 53.77F, "Africa")
dt.Rows.Add("Mali", 20.25F, "Africa")

Me.radTreeMap1.DisplayMember = "Country"
Me.radTreeMap1.ValueMember = "Population"
Me.radTreeMap1.DataSource = dt


See Also

Telerik UI for WinForms Learning Resources

In this article
OSZAR »