Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
   Reporting
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Collapse]Charts Suite
   [Collapse]Chart Control
    [Expand]Getting Started
    [Expand]Fundamentals
    [Expand]Providing Data
    [Expand]Appearance Customization
    [Expand]End-User Features
    [Expand]Design-Time Features
    [Collapse]Visual Elements
      Chart Area
      Chart Title
      Diagram
      Panes
      Axis
      Secondary Axis
      Axis Title
      Axis Labels
      Custom Axis Label
      Axis Tickmarks
      Constant Line
      Constant Line Title
      Grid Lines
      Strip
      Series
      Series Point
      Series Point Marker
      Series Point Label
      Series Title
      Legend
      Legend Marker
      Legend Check Box
      Trend Lines
      Regression Lines
      Moving Average and Envelope
      Fibonacci Indicators
      Annotations
      Oscillator Indicators
      Price Indicators
      Error Bars
      Scale Breaks
      Total Labels
    [Expand]Examples
    [Expand]Additional Resources
   [Expand]Chart3D Control
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Diagram Control
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Series Point Label

Series Point Labels (or Series Labels) are text boxes that accompany series points and provide various information about them. A series label is always in a chart plot area next to the labels' series point.

The appearance or content changing and label overlap resolving may require series label customization and are described in the following sections.

Expanded Appearance Configuration

The table below lists the main appearance properties that affect element appearance and functionality.

Availability The Series.Label property of a series.
Basic properties ChartTextElement.ElementTemplate, System.Windows.Controls.Control.Foreground, System.Windows.Controls.Control.FontFamily, System.Windows.Controls.Control.FontStyle, System.Windows.Controls.Control.FontSize, System.Windows.Controls.Control.FontWeight, System.Windows.Controls.Control.FontStretch
Layout SeriesLabel.Indent, SeriesLabel.ResolveOverlappingMode
Connector Line SeriesLabel.ConnectorVisible, SeriesLabel.ConnectorThickness
Visibility Series.LabelsVisibility,

Expanded Resolve Overlapping

This option enables the repositioning of series point labels to avoid overlapping in a chart.

The SeriesLabel.ResolveOverlappingMode property specifies the algorithm used to resolve overlapping.

The set of available automatic modes depends on the series type. The following table lists all algorithms and explains for which series type an algorithm is available.

Member Description Available for Series Types
None The overlapping resolving algorithm is disabled.

All series types.
Default The default algorithm to re-position labels in a random way, to avoid overlapping labels.

All series types. The default algorithm is specific for each series type group.
HideOverlapped If two or more labels overlap, some of them are automatically hidden, to avoid overlapping.

All series types, except the Pie (Donut) and Funnel series.
JustifyAroundPoint 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 the point center is preserved.

This mode is supported for series view types that visually represent a data point as a point. Thus, this encompasses all series types, except the Pie (Donut), Bars and Financial series.
JustifyAllAroundPoint 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 the point center is preserved.

This mode is supported for series view types that visually represent a data point as a point. Thus, this encompasses all series types, except the Pie (Donut), Bars and Financial series.

To control the distance between labels and their points, use the SeriesLabel.Indent property.

To view a code example, refer to How to: Adjust Series Labels.

Expanded Content Customization

You can control the content of the series labels using the SeriesLabel.TextPattern property. Various placeholders enclosed in braces correspond to the available display patterns. For example, a pair of placeholders specified together (e.g., {A} - {V}), will cause each data point to be represented by both its argument and value, separated by a hyphen.

Note

Series labels of a series are hidden by default. To see how the SeriesLabel.TextPattern property affects the label format, set the Series.LabelsVisibility property to true.

A full list of available placeholders is detailed below.

Pattern Description
{S} Displays the name of the series.
{A} Displays a series point argument.
{V} Displays series point values.
A Pie (Donut) series specific placeholders
{VP} Displays series point values as percentages.
{TV} Displays total group value.
Stacked series specific placeholders
{VP} Displays series point values as percentages.
{G} Displays the name of a stacked group.
{TV} Displays total group value.
A Bubble series specific placeholders
{W} Displays the weight.
Range series specific placeholders
{V1} Displays the first value.
{V2} Displays the second value.
{VD} Displays the duration between the first and second data point values formatted using a common time format (e.g. HH:MM:SS for date time values and #.## for numeric values).
{VDTD} Displays the duration between the first and second date-time data point values in days.
{VDTH} Displays the duration between the first and second date-time data point values in hours.
{VDTM} Displays the duration between the first and second date-time data point values in minutes in minutes.
{VDTS} Displays the duration between the first and second date-time data point values in seconds.
{VDTMS} Displays the duration between the first and second date-time data point values in milliseconds.
Financial series specific placeholders
{OV} Displays the open value.
{HV} Displays the high value.
{LV} Displays the low value.
{CV} Displays the close value.

You can also use standard and custom format specifiers, together with the placeholders (e.g., {V:F1}).

Note

Before specifying the {S} placeholder for a series, make sure a series name is specified in the Series.DisplayName property.

To show X-axis quarter year values on the legend, use the "{A:q}" pattern.

To learn more, refer to the Format Specifiers topic in MSDN.

Expanded See Also

Is this topic helpful?​​​​​​​