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

Plot Band

Updated over 6 months ago

Plot band annotation is a stripe, crossing its corresponding axis, specified by the From and To properties.

Common properties to the three types of annotations include:

BackColor: Sets the back color of the annotation.
BorderDashStyle: Defines the dash style of the border of the annotation.
BorderColor: Sets the color of the border of the annotation.
BorderWidth: Specifies the width of the border of the annotation.

Cartesian Plot Band Annotation

Cartesian plot band annotation is either a horizontal or a vertical stripe that crosses from start to end the vertical or the horizontal axis respectively.

Here is what CartesianPlotBandAnnotation looks like:

Figure 1: CartesianPlotBandAnnotation

WinForms RadChartView Cartesian Plot Band Annotation

Plot Band Annotation Setup

C#
CartesianPlotBandAnnotation annotation1 = new CartesianPlotBandAnnotation();
annotation1.Axis = this.radChartView1.Axes[0] as CartesianAxis;
annotation1.From = 0.5;
annotation1.To = 1.5;
annotation1.BackColor = Color.FromArgb(100, Color.LightBlue);
annotation1.BorderColor = Color.Black;
annotation1.BorderWidth = 1;
this.radChartView1.Annotations.Add(annotation1);
CartesianPlotBandAnnotation annotation2 = new CartesianPlotBandAnnotation();
annotation2.Axis = this.radChartView1.Axes[1] as CartesianAxis;
annotation2.From = 4.5;
annotation2.To = 5.5;
annotation2.BackColor = Color.FromArgb(100, Color.LightBlue);
annotation2.BorderColor = Color.Black;
annotation2.BorderWidth = 1;
this.radChartView1.Annotations.Add(annotation2);
VB.NET
Dim annotation1 As New CartesianPlotBandAnnotation()
annotation1.Axis = TryCast(Me.radChartView1.Axes(0), CartesianAxis)
annotation1.From = 0.5
annotation1.[To] = 1.5
annotation1.BackColor = Color.FromArgb(100, Color.LightBlue)
annotation1.BorderColor = Color.Black
annotation1.BorderWidth = 1
Me.radChartView1.Annotations.Add(annotation1)
Dim annotation2 As New CartesianPlotBandAnnotation()
annotation2.Axis = TryCast(Me.radChartView1.Axes(1), CartesianAxis)
annotation2.From = 4.5
annotation2.[To] = 5.5
annotation2.BackColor = Color.FromArgb(100, Color.LightBlue)
annotation2.BorderColor = Color.Black
annotation2.BorderWidth = 1
Me.radChartView1.Annotations.Add(annotation2)

Properties:

Axis: The Cartesian plotBand annotation needs to be associated with horizontal or vertical axis explicitly.
From (of type object): The starting point for the plot band. When the associated axis is numerical (Linear or Logarithmic) a numeric value is expected and when it is a CategoricalAxis - a category.
To (of type object): The ending point for the plot band. When the associated axis is numerical (Linear or Logarithmic) a numeric value is expected and when it is a CategoricalAxis - a category.
Label: This property allows you to display text near the annotation and indicate what it is for.

Polar Axis Plot Band Annotation

The Polar axis plot band annotation resembles a donut.

Here is what PolarAxisPlotBandAnnotation looks like:

Figure 2: PolarAxisPlotBandAnnotation

WinForms RadChartView Polar Axis Plot Band Annotation

Polar Axis Annotation

C#
PolarAxisPlotBandAnnotation annotation1 = new PolarAxisPlotBandAnnotation();
annotation1.From = 6;
annotation1.To = 8;
annotation1.BackColor = Color.FromArgb(100, Color.LightBlue);
annotation1.BorderColor = Color.Black;
annotation1.BorderWidth = 1;
annotation1.BorderDashStyle = DashStyle.Solid;
this.radChartView1.Annotations.Add(annotation1);
VB.NET
Dim annotation1 As New PolarAxisPlotBandAnnotation()
annotation1.From = 6
annotation1.[To] = 8
annotation1.BackColor = Color.FromArgb(100, Color.LightBlue)
annotation1.BorderColor = Color.Black
annotation1.BorderWidth = 1
annotation1.BorderDashStyle = DashStyle.Solid
Me.radChartView1.Annotations.Add(annotation1)

Properties:

From (of type double): The starting point for the plot band.
To (of type double): The ending point for the plot band.

Radial Axis Plot Band Annotation

Radial axis plot band annotations represent visually a sector of the circle (pie slice).

A plot band starting from 180 degrees and ending in 270 degrees will look like this:

Figure 3: RadialAxisPlotBandAnnotation

WinForms RadChartView Radial Axis Plot Band Annotation

Radial Axis Annotations

C#
RadialAxisPlotBandAnnotation annotation1 = new RadialAxisPlotBandAnnotation();
annotation1.From = 180;
annotation1.To = 270;
this.radChartView1.Annotations.Add(annotation1);
VB.NET
Dim annotation1 As New RadialAxisPlotBandAnnotation()
annotation1.From = 180
annotation1.[To] = 270
Me.radChartView1.Annotations.Add(annotation1)

If you wonder how to annotate the bigger segment from the image above, then you should use the From and To values.

Figure 3: Annotated Bigger Segment

WinForms RadChartView Annotated Bigger Segment

Define Bigger Segment

C#
RadialAxisPlotBandAnnotation annotation1 = new RadialAxisPlotBandAnnotation();
annotation1.From = 270;
annotation1.To = 180;
this.radChartView1.Annotations.Add(annotation1);
VB.NET
Dim annotation1 As New RadialAxisPlotBandAnnotation()
annotation1.From = 270
annotation1.[To] = 180
Me.radChartView1.Annotations.Add(annotation1)

Properties:

From (of type object): The starting point for the plot band. When the Radial axis is NumericRadialAxis a numeric value is expected and when it is a CategoricalRadialAxis - a category.
To (of type object): Tthe ending point for the plot band. When the Radial axis is NumericRadialAxis a numeric value is expected and when it is a CategoricalRadialAxis - a category.