label

Each series point can be accompanied by a text label that represents data related to the point. These are called series point labels. Use the label object's properties to set label options for the series.

View Demo

See Also

• format - provides a comprehensive overview of formatting capabilities.
• Data Formatting - shows how to apply formatting to various widget elements.

Labels are painted in the color of the series points they represent by default. You can set a custom background color. For this purpose, use the backgroundColor property of the label object.

Use this object to make the borders of point labels visible/invisible and set up border options such as color and width.

A series point label can be placed separately near the represented point. To make the relationship between a label and its respective point clear, use a connector. Set the connector's visibility and appearance options using the connector object.

When implementing a callback function for this property, use the point value to be displayed in a label. In addition, you can use the argument of the currently displayed value. These values can be accessed using the following properties of the this object.

• value
  Specifies the value of the currently represented point.
• valueText
  Specifies the value of the currently represented point with applied formatting if the format property is specified.
• argument
  Specifies the argument value of the currently represented point.
• argumentText
  Specifies the argument value of the currently represented point with applied formatting if the argumentFormat property is specified.
• percent
  Specifies the proportional value of the currently represented point in a floating point format.
• percentText
  Specifies the value of the currently represented point as a percentage with a precision of the format | percentPrecision option.
• point.tag
  Specifies the tag of the currently represented point.

The function's parameter represents the same object as the this object. If appropriate, you can use the function's parameter to obtain the value that is currently represented by a label.

To get general information on data formatting, refer to the Data Formatting topic.

See Also

• format - provides a comprehensive overview of formatting capabilities.
• Data Formatting - shows how to apply formatting to various widget elements.

When configuring the widget using ASP.NET MVC Wrappers, specify this option using the PieChartLabelPosition enum. This enum accepts the following values: Outside, Inside and Columns.

View Demo