• Post category:ApiChart
  • Запись изменена:17.04.2023

AddSeria(sNameRange, sValuesRange, [sXValuesRange])

Добавляет новую серию в текущую диаграмму.

Параметры:

Название Тип По умолчанию Описание
sNameRange строковый Имя серии. Может быть диапазоном ячеек или обычным текстом. Например:

  • «‘sheet 1’!$A$2:$A$5» — должна быть одна ячейка, строка или столбец,
  • «A1:A5» — должна быть одна ячейка, строка или столбец,
  • «Example series».
sValuesRange строковый Диапазон ячеек листа со значениями серии. Например:

  • «‘sheet 1’!$A$2:$A$5» — должна быть одна ячейка, строка или столбец,
  • «A1:A5» — должна быть одна ячейка, строка или столбец.
sXValuesRange строковый null Диапазон ячеек на листе с рядом значений по оси x. Он используется только с точечными диаграммами. Например:

  • «‘sheet 1’!$A$2:$A$5» -должна быть одна ячейка, строка или столбец,
  • «A1:A5» — должна быть одна ячейка, строка или столбец.

Возвращает:

Этот метод не возвращает никаких данных.

Пример

builder.CreateFile("xlsx");
var oWorksheet = Api.GetActiveSheet();
oWorksheet.GetRange("B1").SetValue(2014);
oWorksheet.GetRange("C1").SetValue(2015);
oWorksheet.GetRange("D1").SetValue(2016);
oWorksheet.GetRange("A2").SetValue("Projected Revenue");
oWorksheet.GetRange("A3").SetValue("Estimated Costs");
oWorksheet.GetRange("A4").SetValue("Cost price");
oWorksheet.GetRange("B2").SetValue(200);
oWorksheet.GetRange("B3").SetValue(250);
oWorksheet.GetRange("B4").SetValue(50);
oWorksheet.GetRange("C2").SetValue(240);
oWorksheet.GetRange("C3").SetValue(260);
oWorksheet.GetRange("C4").SetValue(120);
oWorksheet.GetRange("D2").SetValue(280);
oWorksheet.GetRange("D3").SetValue(280);
oWorksheet.GetRange("D4").SetValue(160);
var oChart = oWorksheet.AddChart("'Sheet1'!$A$1:$D$3", true, "bar3D", 2, 100 * 36000, 70 * 36000, 0, 2 * 36000, 7, 3 * 36000);
oChart.SetTitle("Financial Overview", 13);
oChart.AddSeria("Cost price", "'Sheet1'!$B$4:$D$4");
var oFill = Api.CreateSolidFill(Api.CreateRGBColor(51, 51, 51));
oChart.SetSeriesFill(oFill, 0, false);
oFill = Api.CreateSolidFill(Api.CreateRGBColor(255, 111, 61));
oChart.SetSeriesFill(oFill, 1, false);
builder.SaveFile("xlsx", "AddSeria.xlsx");
builder.CloseFile();