Edit this page

Plot Band

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

chartview-annotations-plotband-annotations 001

Plot Band Annotation Setup

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);

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

chartview-annotations-plotband-annotations 002

Polar Axis Annotation

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);

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

chartview-annotations-plotband-annotations 003

Radial Axis Annotations

RadialAxisPlotBandAnnotation annotation1 = new RadialAxisPlotBandAnnotation();
annotation1.From = 180;
annotation1.To = 270;
this.radChartView1.Annotations.Add(annotation1);

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

chartview-annotations-plotband-annotations 004

Define Bigger Segment

RadialAxisPlotBandAnnotation annotation1 = new RadialAxisPlotBandAnnotation();
annotation1.From = 270;
annotation1.To = 180;
this.radChartView1.Annotations.Add(annotation1);

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.

See Also