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

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

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

Параметры:

НазваниеТипОписание
sDataRangeстроковыйВыбранный диапазон ячеек, который будет использоваться для получения данных для диаграммы, формируется специально и включает имя листа.
bInRowsлогическийУказывает, следует ли брать данные из строк или из столбцов. Если true, будут использоваться данные из строк.
sTypeChartTypeТип диаграммы, используемый для отображения диаграммы.
nStyleIndexчисленныйИндекс цветового стиля диаграммы (может принимать значения от 1 до 48, как описано в спецификации OOXML).
nExtXEMUШирина диаграммы в английских единицах измерения
nExtYEMUВысота диаграммы в английских единицах измерения
nFromColчисленныйНомер столбца, в который будет помещено начало диаграммы.
nColOffsetEMUСмещение от столбца nFromCol до левой части диаграммы, измеренное в английских единицах измерения.
nFromRowчисленныйНомер строки, в которую будет помещено начало диаграммы.
nRowOffsetEMUСмещение от строки 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();