Custom Axis Annotation

In some situations you may need to create custom axis annotation. The following scenarios can be useful for creating custom axis annotation:

When the Axis.ItemsSource property is a collection of numbers or DateTime values the chart uses these values as axis labels. The following code uses the Axis.ItemsSource property to create the custom Y-axis labels:

C#	Copy Code
c1Chart1.Reset(true); c1Chart1.Data.Children.Add( new DataSeries() { ValuesSource = new double[] { 1, 2, 1, 3, 1, 4 } }); c1Chart1.ChartType = ChartType.LineSymbols; c1Chart1.View.AxisY.ItemsSource = new double[] { 1.25, 1.5, 1.75, 4 };

Copy Code

c1Chart1.Reset(true);
c1Chart1.Data.Children.Add(
   new DataSeries() { ValuesSource = new double[] { 1, 2, 1, 3, 1, 4 } });
c1Chart1.ChartType = ChartType.LineSymbols;
c1Chart1.View.AxisY.ItemsSource = new double[] { 1.25, 1.5, 1.75, 4 };

When the Axis.ItemsSource property is a collection of KeyValuePair<object, double> or KeyValuePair<object, DateTime> the chart creates axis labels based on the provided pairs of values. For example, the following code uses the KeyValuePair to create the custom axis annotation for the Y axis:

C#	Copy Code
c1Chart1.Data.Children.Add( new DataSeries() { ValuesSource = new double[] { 1, 2, 1, 3, 1, 4 } }); c1Chart1.ChartType = ChartType.LineSymbols; c1Chart1.View.AxisY.ItemsSource = new List<KeyValuePair<object,double>> { new KeyValuePair<object,double>("Min=1", 1), new KeyValuePair<object,double>("Average=2.5", 2.5), new KeyValuePair<object,double>("Max=4", 4)};

Copy Code

c1Chart1.Data.Children.Add(
          new DataSeries() { ValuesSource = new double[] { 1, 2, 1, 3, 1, 4 } });
c1Chart1.ChartType = ChartType.LineSymbols;
c1Chart1.View.AxisY.ItemsSource = new List<KeyValuePair<object,double>>
  { new KeyValuePair<object,double>("Min=1", 1),
    new KeyValuePair<object,double>("Average=2.5", 2.5),
    new KeyValuePair<object,double>("Max=4", 4)};

You can use the Axis.ItemsValueBinding and Axis.ItemsLabelBinding properties to create axis labels using arbitrary collection as data source, like in the following code:

C#	Copy Code
Point[] pts = new Point[] { new Point(1, 1.3), new Point(2, 2.7), new Point(3, 3.9) }; c1Chart1.DataContext = pts; c1Chart1.ChartType = ChartType.LineSymbols; c1Chart1.View.AxisY.ItemsSource = pts; c1Chart1.View.AxisY.ItemsValueBinding = new Binding("Y"); c1Chart1.View.AxisY.ItemsLabelBinding = new Binding();

Copy Code

Point[] pts = new Point[] { new Point(1, 1.3), new Point(2, 2.7), new Point(3, 3.9) };
  c1Chart1.DataContext = pts;
  c1Chart1.ChartType = ChartType.LineSymbols;
  c1Chart1.View.AxisY.ItemsSource = pts;
  c1Chart1.View.AxisY.ItemsValueBinding = new Binding("Y");
  c1Chart1.View.AxisY.ItemsLabelBinding = new Binding();