CreateChart
使用指定的参数创建图表。
语法
expression.CreateChart(sType, aSeries, aSeriesNames, aCatNames, nWidth, nHeight, nStyleIndex, aNumFormats);
expression - 表示 Api 类的变量。
参数
| 名称 | 必需/可选 | 数据类型 | 默认值 | 描述 |
|---|---|---|---|---|
| sType | 可选 | ChartType | "bar" | 用于图表显示的图表类型。 |
| aSeries | 必需 | number[][] | 用于构建图表的数据数组。 | |
| aSeriesNames | 必需 | number[] | string[] | 用于构建图表的数据所使用的名称数组（源表列名）。 | |
| aCatNames | 必需 | number[] | string[] | 用于构建图表的数据所使用的名称数组（源表行名）。 | |
| nWidth | 必需 | EMU | 以英制度量单位表示的图表宽度。 | |
| nHeight | 必需 | EMU | 以英制度量单位表示的图表高度。 | |
| nStyleIndex | 必需 | number | 图表颜色样式索引（可以是 1 - 48，如 OOXML 规范所述）。 | |
| aNumFormats | 必需 | NumFormat[] | String[] | 将应用于系列的数字格式（可以是自定义格式）。默认数字格式为"常规"。 |
返回值
示例
此示例展示如何创建图表并将其粘贴到文档中。
// How to add charts to slides.
// Create a 3D bar chart, set its size, position, color and other properties.
const presentation = Api.GetPresentation();
const slide = presentation.GetSlideByIndex(0);
slide.RemoveAllObjects();
const chart = Api.CreateChart("bar3D", [
[200, 240, 280],
[250, 260, 280]
], ["Projected Revenue", "Estimated Costs"], [2014, 2015, 2016], 4051300, 2347595, 24, ["0", "0.00"]);
chart.SetSize(300 * 36000, 130 * 36000);
chart.SetPosition(608400, 1267200);
chart.SetShowPointDataLabel(1, 0, false, false, true, false);
let fill = Api.CreateSolidFill(Api.RGB(51, 51, 51));
chart.SetSeriesFill(fill, 0, false);
fill = Api.CreateSolidFill(Api.RGB(255, 111, 61));
chart.SetSeriesFill(fill, 1, false);
slide.AddObject(chart);