Value Labels Annotation

A very flexible type of annotation, ValueLabels displays text defined at a specific axis coordinate. This annotation is useful in labeling only specific coordinates or when producing annotation in a form that the chart does not provide. ValueLabels annotation can be used for any axis, with any chart type, and with any data layout, with the exception of Pie charts.

If the AnnoMethod property is set to AnnotationMethod.ValueLabels the chart places labels at explicit locations along an axis. The ValueLabels property, which is a ValueLabels collection, supplies this list of strings and their locations. For example, the following code sets chart labels at the locations 1, 2 and 3:

· Visual Basic

With C1Chart1.ChartArea.AxisX.ValueLabels

.Add(1, "one")

.Add(2, "two")

.Add(3, "three")

End With

C1Chart1.ChartArea.AxisX.AnnoMethod = AnnotationMethodEnum.ValueLabels

· C#

ValueLabelsCollecton VlColl = C1Chart1.ChartArea.AxisX.ValueLabels;

VlColl.Add(1, "one");

VlColl.Add(2, "two");

VlColl.Add(3, "three");

C1Chart1.ChartArea.AxisX.AnnoMethod = AnnotationMethodEnum.ValueLabels;

· Delphi

var

VlColl: ValueLabelsCollection;

begin

VlColl := C1Chart1.ChartArea.AxisX.ValueLabels;

VlColl.Add(1, 'one');

VlColl.Add(2, 'two');

VlColl.Add(3, 'three');

C1Chart1.ChartArea.AxisX.AnnoMethod := AnnotationMethodEnum.ValueLabels;

end;

ValueLabels can also be modified at design time through the ValueLabel Collection Editor. For more information on the ValueLabel Collection Editor, see ValueLabel Collection Editor.

The following chart illustrates the Text, Appearance, BackColor, Color, MarkerSize, and Moveable properties from the ValueLabel class.

Notice that label's appearance for the numeric value's 1 and 2 are displayed as an arrow. You can set the appearance property for your label at design time or run time.

At design time you can set the label's appearance property by selecting one of the following label types: Label, Triangle Marker, ArrowMarker, or CustomMarker in the ValueLabel Collection Editor. The appearance property of the label class gets the value of the ValueLabelAppearanceEnum. At run time you can set the label's appearance property by using the following code:

· Visual Basic

vl.Appearance = ValueLabelAppearanceEnum.ArrowMarker

· C#

vl.Appearance = ValueLabelAppearanceEnum.ArrowMarker;

· Delphi

vl.Appearance := ValueLabelAppearanceEnum.ArrowMarker;

Note: In the example above the text, vl, represents the variable name of the value label.

The MarkerSize property illustrated below shows how the markers appear when they are set to different sizes. By setting the Moveable property to True for each marker label, you can slide M1 and M2 along the x-axis. This is often useful as an input device for specifying axis values that affect charts with Cartesian coordinates. The two grid lines associated with the ValueLabels below help serve as a visual aid for the two markers.

Individual members of the ValueLabels collection can be accessed in one of three ways: by typing in the ValueLabel index (0-based), by referencing the ValueLabel value to be replaced, or by referencing the ValueLabel text value. For instance, the following three lines of code all set the first member of the ValueLabels collection that has a Value of 1 to the text “one”:

· Visual Basic

C1Chart1.ChartArea.AxisX.ValueLabels(0).Text = "one"

C1Chart1.ChartArea.AxisX.ValueLabels(1.0).Text = "one"

C1Chart1.ChartArea.AxisX.ValueLabels("one").Text = "one"

· C#

C1Chart1.ChartArea.AxisX.ValueLabels[0].Text = "one";

C1Chart1.ChartArea.AxisX.ValueLabels[1.0].Text = "one";

C1Chart1.ChartArea.AxisX.ValueLabels["one"].Text = "one";

· Delphi

begin

C1Chart1.ChartArea.AxisX.ValueLabels[0].Text = 'one';

C1Chart1.ChartArea.AxisX.ValueLabels[1.0].Text = 'one';

C1Chart1.ChartArea.AxisX.ValueLabels['one'].Text = 'one';

end;