Skip to main content

SetShowDataLabels

Specifies which chart data labels are shown for the chart.

Syntax​

expression.SetShowDataLabels(bShowSerName, bShowCatName, bShowVal, bShowPercent);

expression - A variable that represents a ApiChart class.

Parameters​

NameRequired/OptionalData typeDefaultDescription
bShowSerNameRequiredbooleanWhether to show or hide the source table column names used for the data which the chart will be build from.
bShowCatNameRequiredbooleanWhether to show or hide the source table row names used for the data which the chart will be build from.
bShowValRequiredbooleanWhether to show or hide the chart data values.
bShowPercentRequiredbooleanWhether to show or hide the percent for the data values (works with stacked chart types).

Returns​

boolean

Example​

Control which data label elements are displayed on a chart in a spreadsheet.

// How do I choose what information appears in chart data labels in a spreadsheet?

// Show only the numeric values on chart bars while hiding category names and percentages in a spreadsheet.

let worksheet = Api.GetActiveSheet();
worksheet.GetRange("B1").SetValue(2014);
worksheet.GetRange("C1").SetValue(2015);
worksheet.GetRange("D1").SetValue(2016);
worksheet.GetRange("A2").SetValue("Projected Revenue");
worksheet.GetRange("A3").SetValue("Estimated Costs");
worksheet.GetRange("B2").SetValue(200);
worksheet.GetRange("B3").SetValue(250);
worksheet.GetRange("C2").SetValue(240);
worksheet.GetRange("C3").SetValue(260);
worksheet.GetRange("D2").SetValue(280);
worksheet.GetRange("D3").SetValue(280);
let chart = worksheet.AddChart("'Sheet1'!$A$1:$D$3", true, "bar3D", 2, 100 * 36000, 70 * 36000, 0, 2 * 36000, 5, 3 * 36000);
chart.SetTitle("Financial Overview", 13);
chart.SetShowDataLabels(false, false, true, false);
let fill = Api.CreateSolidFill(Api.RGB(51, 51, 51));
chart.SetSeriesFill(fill, 0, false);
fill = Api.CreateSolidFill(Api.RGB(255, 111, 61));
chart.SetSeriesFill(fill, 1, false);