• Post category:ApiWorksheet
  • Запись изменена:10.12.2023

AddChart(sDataRange, bInRows, sType, nStyleIndex, nExtX, nExtY, nFromCol, nColOffset, nFromRow, nRowOffset) → { ApiChart }

Создает диаграмму указанного типа из выбранного диапазона данных текущего листа. Пожалуйста, обратите внимание, что смещения по горизонтали и вертикали рассчитываются только в пределах указанных ячеек столбца и строки. Если это значение превышает ширину или высоту ячейки, будет установлено другое вертикальное/горизонтальное положение.

Параметры:

Название Тип Описание
sDataRange строковый Выбранный диапазон ячеек, который будет использоваться для получения данных для диаграммы, формируется специально и включает имя листа.
bInRows логический Указывает, следует ли брать данные из строк или из столбцов. Если true, будут использоваться данные из строк.
sType ChartType Тип диаграммы, используемый для отображения диаграммы.
nStyleIndex численный Индекс цветового стиля диаграммы (может принимать значения от 1 до 48, как описано в спецификации OOXML).
nExtX EMU Ширина диаграммы в английских единицах измерения
nExtY EMU Высота диаграммы в английских единицах измерения
nFromCol численный Номер столбца, в который будет помещено начало диаграммы.
nColOffset EMU Смещение от столбца nFromCol до левой части диаграммы, измеренное в английских единицах измерения.
nFromRow численный Номер строки, в которую будет помещено начало диаграммы.
nRowOffset EMU Смещение от строки nFromRow до верхней части диаграммы, измеренное в английских единицах измерения.

Возвращает:

Тип ApiChart

Пример

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("B2").SetValue(200);
oWorksheet.GetRange("B3").SetValue(250);
oWorksheet.GetRange("C2").SetValue(240);
oWorksheet.GetRange("C3").SetValue(260);
oWorksheet.GetRange("D2").SetValue(280);
oWorksheet.GetRange("D3").SetValue(280);
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);
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", "AddChart.xlsx");
builder.CloseFile();