Show All

Hide All

You can use Labels in Chart markers or legends.

By default, marker labels display Y value of data points, whereas legend labels display series name or data name.

Setting Strings

You can change a string (format string) displayed in a marker or legend label.

To change a string in a marker label

To change a string in a legend label

Symbols

It is possible to easily display constant strings by simply performing the above mentioned settings. To display data, you need to embed the section (placeholder) that displays the value within format string at runtime.

A placeholder is a particular symbol enclosed within brackets {}.

The following symbols can be used. The sections enclosed within {} are changed by values.

Value

   Data Value（Y value）

Pct

   Percentage within series

PPct

   Percentage having 100% as sum of multiple series for data points.

Name

   X value of data

Index

   Index of data point

Total

Total number of series

PTotal

Total number of multiple series for data points

When displaying numeric value, it is possible to set format specifying string similar to System.String.Format method used when displaying numeric values. For example, when format string is {Value}, numeric value is displayed in default format but when ":" (colon) format specifying string is added after Value, it is possible to insert comma or specify decimal place digits.

For example, the format string for "inserting comma in numeric value and displaying 2 digits after decimal place" would be as follows.

{Value:#,##0.00}

Please refer to the technical information posted on Microsoft site for details on format specifying string after continued numeric value after comma.

• [Format Function]
• [User defined numeric value format (Format function)]

Sample Image

The following image displays a bar chart with the following values.

String displayed below the image is a string set in Label.Format property of marker.

Private Sub rptLabelSymbol4_ReportStart(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.ReportStart

Dim m As GrapeCity.ActiveReports.Chart.Marker
m = CType(Me.ChartControl1.Series(0).Properties("Marker"), GrapeCity.ActiveReports.Chart.Marker)
m.Label.Format = "{Name}" & vbCrLf & "{Value}"
End Sub
                                

private void NewActiveReport1_ReportStart(object sender, EventArgs e)
{
GrapeCity.ActiveReports.Chart.Marker m;
m = (GrapeCity.ActiveReports.Chart.Marker)
this.ChartControl1.Series[0].Properties["Marker"];
m.Label.Format = "{Name}\n{Value}";
}