Series Point Label
- 3 minutes to read
This document describes the customizations available for point labels such as the smart automatic positioning (resolve overlapping) of point labels, the formatting of their content as well as the main appearance options.
This topic consists of the following sections.
#Series Point Label
Series Point Labels (also referred to as Series Labels) are used to identify a particular series point within a series. They are displayed inside plotting areas, next to the data point. Centralized customization of series labels is performed at the series level.
You can enable automatic correction of overlapping series labels via the SeriesLabel.ResolveOverlappingMode property.
The table below lists the main properties that affect element appearance and functionality.
Availability | The Series. |
Appearance | Chart |
Layout | |
Connector Line | Series |
Visibility |
#Resolve Overlapping
This option intelligently arranges series point labels to avoid a mess in your chart.
To choose the best-fit algorithm that resolves the overlapping of series labels, use the SeriesLabel.ResolveOverlappingMode property.
The set of automatic modes depends on the series type.
To control the distance between labels and their points, use the SeriesLabel.Indent property.
To customize the resolve overlapping algorithm, use the following properties:
| Member | Description |
|---|---|
| Resolve |
The default algorithm re-positions labels randomly, to avoid overlapping labels. |
| Resolve |
If two or more labels overlap, some of them are automatically hidden, to avoid overlapping. |
| Resolve |
All labels (both overlapping and non-overlapping) change their position. They are re-positioned in such a way, so that they are moved around the corresponding point's center, but their indent from it is preserved. |
| Resolve |
Only labels that are overlapping change their position. They are re-positioned in such a way, so that they are moved around the corresponding point's center, but their indent from it is preserved. |
| Resolve |
The overlapping resolving algorithm for series labels is disabled. |
Refer to see How to: Adjust Series Labels to view a code eaxample.
#Content
You can control the format of the content, or how data is presented by the point labels, using the Series.PointOptions.
Depending on the scale type being used, use the corresponding properties to format the point label output.
- PointOptions.ArgumentNumericOptions and PointOptions.ValueNumericOptions;
- PointOptions.ArgumentDateTimeOptions and PointOptions.ValueDateTimeOptions.
#Appearance
Use the Series.LabelsVisibility property to control the visibility of series point labels on a diagram.
To show or hide the connector drawn between labels and their points, use the SeriesLabel.ConnectorVisible property.
The appearance of series labels can be completely redefined using the ChartTextElement.ElementTemplate property. For more information, refer to the How to: Provide a Custom Template for Series Labels tutorial.
In addition, you can specify point marker models for Area, Point, Line and Bubble series.