ChartDataLabel Class |
Namespace: Aspose.Words.Drawing.Charts
The ChartDataLabel type exposes the following members.
Name | Description | |
---|---|---|
![]() ![]() | Index |
Specifies the index of the containing element.
This index shall determine which of the parent's children collection this element applies to.
Default value is 0.
|
![]() ![]() | IsVisible |
Returns true if this data label has something to display.
|
![]() ![]() | NumberFormat |
Returns number format of the parent element.
|
![]() ![]() | Separator |
Gets or sets string separator used for the data labels on a chart.
The default is a comma, except for pie charts showing only category name and percentage, when a line break
shall be used instead.
|
![]() ![]() | ShowBubbleSize |
Allows to specify if bubble size is to be displayed for the data labels on a chart.
Applies only to Bubble charts.
Default value is false.
|
![]() ![]() | ShowCategoryName |
Allows to specify if category name is to be displayed for the data labels on a chart.
Default value is false.
|
![]() ![]() | ShowDataLabelsRange |
Allows to specify if values from data labels range to be displayed in the data labels.
Default value is false.
|
![]() ![]() | ShowLeaderLines |
Allows to specify if data label leader lines need be shown.
Default value is false.
|
![]() ![]() | ShowLegendKey |
Allows to specify if legend key is to be displayed for the data labels on a chart.
Default value is false.
|
![]() ![]() | ShowPercentage |
Allows to specify if percentage value is to be displayed for the data labels on a chart.
Default value is false.
|
![]() ![]() | ShowSeriesName |
Returns or sets a Boolean to indicate the series name display behavior for the data labels on a chart.
True to show the series name. False to hide. By default false.
|
![]() ![]() | ShowValue |
Allows to specify if values are to be displayed in the data labels.
Default value is false.
|
Name | Description | |
---|---|---|
![]() | Equals | (Inherited from Object.) |
![]() | Finalize | (Inherited from Object.) |
![]() | GetHashCode | (Inherited from Object.) |
![]() | GetType | (Inherited from Object.) |
![]() | MemberwiseClone | (Inherited from Object.) |
![]() | ToString | (Inherited from Object.) |
public void ChartDataLabels() { Document doc = new Document(); DocumentBuilder builder = new DocumentBuilder(doc); // Use a document builder to insert a bar chart Shape chartShape = builder.InsertChart(ChartType.Line, 400, 300); // Get the chart object from the containing shape Chart chart = chartShape.Chart; // The chart already contains demo data comprised of 3 series each with 4 categories Assert.AreEqual(3, chart.Series.Count); Assert.AreEqual("Series 1", chart.Series[0].Name); // Apply data labels to every series in the graph foreach (ChartSeries series in chart.Series) { ApplyDataLabels(series, 4, "000.0", ", "); Assert.AreEqual(4, series.DataLabels.Count); } // Get the enumerator for a data label collection using (IEnumerator<ChartDataLabel> enumerator = chart.Series[0].DataLabels.GetEnumerator()) { // And use it to go over all the data labels in one series and change their separator while (enumerator.MoveNext()) { Assert.AreEqual(", ", enumerator.Current.Separator); enumerator.Current.Separator = " & "; } } // If the chart looks too busy, we can remove data labels one by one chart.Series[1].DataLabels.RemoveAt(2); // We can also clear an entire data label collection for one whole series chart.Series[2].DataLabels.Clear(); doc.Save(ArtifactsDir + "Charts.ChartDataLabels.docx"); } /// <summary> /// Apply uniform data labels with custom number format and separator to a number (determined by labelsCount) of data points in a series /// </summary> private void ApplyDataLabels(ChartSeries series, int labelsCount, string numberFormat, string separator) { for (int i = 0; i < labelsCount; i++) { ChartDataLabel label = series.DataLabels.Add(i); Assert.False(label.IsVisible); // Edit the appearance of the new data label label.ShowCategoryName = true; label.ShowSeriesName = true; label.ShowValue = true; label.ShowLeaderLines = true; label.ShowLegendKey = true; label.ShowPercentage = false; Assert.False(label.ShowDataLabelsRange); // Apply number format and separator label.NumberFormat.FormatCode = numberFormat; label.Separator = separator; // The label automatically becomes visible Assert.True(label.IsVisible); } }