• Post category:API
  • Запись изменена:09.05.2023

CreateChart([sType], aSeries, aSeriesNames, aCatNames, nWidth, nHeight, nStyleIndex, aNumFormats) → { ApiChart }

Создает график с заданными параметрами.

Параметры:

НазваниеТипПо умолчаниюОписание
sTypeChartType«bar»Тип графика, используемый для его отображения.
aSeriesмассивМассив данных, на основе которых строится график.
aSeriesNamesмассивМассив имен (имен столбцов исходной таблицы), используемых для данных, на основе которых будет строиться график.
aCatNamesмассивМассив имен (имен строк исходной таблицы), используемых для данных, на основе которых будет строиться график.
nWidthEMUШирина графика в английских единицах измерения.
nHeightEMUВысота графика в английских единицах измерения.
nStyleIndexчисленныйИндекс стиля цвета графика (может быть 1 — 48, как описано в спецификации OOXML).
aNumFormatsArray.<NumFormat> | Array.<String>Числовые форматы, которые будут применяться к серии (могут быть произвольными форматами). Числовой формат по умолчанию — «Общий».

Возвращает:

Тип ApiChart

Пример

builder.CreateFile("docx");
var oDocument = Api.GetDocument();
var oParagraph = oDocument.GetElement(0);
var oChart = Api.CreateChart("bar3D", [
  [200, 240, 280],
  [250, 260, 280]
], ["Projected Revenue", "Estimated Costs"], [2014, 2015, 2016], 4051300, 2347595, 24);
oParagraph.AddDrawing(oChart);
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("docx", "CreateChart.docx");
builder.CloseFile();