Skip to main content

Chart

A chart in a PowerPoint graphic frame. Read it with Shape.getChart(). Import from @reductoai/pptx/officejs.

Chart properties

Chart.addSeries()

Append a series, modelled on the target plot’s last one (axis wiring and cache structure are cloned; the theme’s accent cycle colours it). For a combo chart, plotKind picks the family (“column”, “line”, …); default is the first plot. Omitting name leaves the legend entry blank.

Chart.assertLive()

Throws when the frame left its part.

Chart.chartRoot()

The live c:chartSpace root.

Chart.colorStyle()

The chart’s cs:colorStyle part; a host that keeps none reads as Excel’s default.

Chart.detached()

Chart.embeddedWorkbook()

The workbook the chart embeds, as Edit Data opens it; undefined for a linked or missing one.

Chart.embedWorkbook()

Embeds a workbook in a chart that has none; its references must already read it.

Chart.frameSizePt()

The frame’s size in points, for plot-area geometry.

Chart.getDataTable()

Excel.Chart.getDataTable(): throws when the chart type cannot show one.

Chart.getDataTableOrNullObject()

Excel.Chart.getDataTableOrNullObject(): isNullObject when the chart type cannot show one.

Chart.keepingWorkbook()

Runs an edit that leaves the data alone; the embedded workbook is not rebuilt for it.

Chart.linkedWorkbook()

The file the chart links its data to, when it lives outside the deck.

Chart.noteChange()

Chart.seal()

Chart.setColorStyle()

Chart.setEmbeddedWorkbook()

Replaces the embedded workbook; save keeps it as it is.

Chart.styleAxisTitle()

The look a new axis title takes: Office’s 10pt grey on a styled chart.

Chart.textRef()

A c:strRef with its cache for a cell formula; a host without cells leaves it empty.

Chart.themePalette()

ChartSeries

Import from @reductoai/pptx/officejs.

ChartSeries properties

ChartSeries.delete()

Remove this series from its plot. The handle is dead afterwards.

ChartSeries.moveTo()

Move this series to chart-space position index (the order chart.series lists). Paint stacking, legend order and the automatic accent cycle follow. A series never changes plot families. The frozen index snapshot does not renumber; re-read chart.series.

ChartSeries.set()

Sets several properties at once; a navigation member takes a nested batch.

ChartAddOptions

addChart options: the chart data plus the frame’s box in points. Import from @reductoai/pptx/officejs.