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

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

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

Параметры:

Название Тип По умолчанию Описание
sType ChartType «bar» Тип графика, используемый для его отображения.
aSeries массив Массив данных, на основе которых строится график.
aSeriesNames массив Массив имен (имен столбцов исходной таблицы), используемых для данных, на основе которых будет строиться график.
aCatNames массив Массив имен (имен строк исходной таблицы), используемых для данных, на основе которых будет строиться график.
nWidth EMU Ширина графика в английских единицах измерения.
nHeight EMU Высота графика в английских единицах измерения.
nStyleIndex численный Индекс стиля цвета графика (может быть 1 — 48, как описано в спецификации OOXML).
aNumFormats Array.<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();