Skip to main content
The headless slide editor: commands, selection and undo over a deck. Guide: Headless editor.

PptxEditor

Headless slide editing over the PowerPoint facade: commands in, a laid-out view out. Import from @reductoai/pptx/editor.

PptxEditor properties

PptxEditor.open()

apply()

backgroundStyles()

Design > Background Styles: the twelve cells as the current page’s theme draws them.

chartWorkbook()

The selected chart’s workbook for Edit Data; undefined when it reads none it embeds.

clipPicture()

Paste Special > Picture: the copied shapes alone on a page with no background, and the box their ink covers (hmm). The host paints that box and adds it with addPicture.

commentStep()

Review > Previous or Next from active, the thread a host’s pane shows; undefined when the deck has none.

connectionSites()

Where a connector end can glue on the current slide: each site of each shape, in page hmm.

external()

Runs an edit made around the editor (a script, an agent) on presentation as one undo step, then lays every slide out again. Edits made before a throw stand; a run that changed nothing adds no step.

find()

Every match of query in the deck (or the masters in Master view), slide by slide in shape order.

headerFooter()

What Insert > Header & Footer shows for a slide.

layoutPending()

Lays out up to count blank slides, nearest the one on screen first, and returns the view; pendingSlides says how many are left.

layoutPreviews()

One page per entry of view.layouts, for the Layout gallery’s thumbnails; laid again only after an edit.
What Insert > Link shows: the selection’s link, its text to display; undefined where a link cannot go.

mediaBlob()

A media part a picture plays (SlideObject.media.part) as a Blob of type; null when the package lacks it.

mediaTiming()

How the slide’s videos and sounds play: settings, start and click calls, triggers.

merge()

Writes another writer’s change (run returns the parts it wrote) and lays out what it touched, keeping the selection on the same shapes and text. Undo steps made before it would put back its parts too, so they are dropped.

notesPage()

View > Notes Page: the frames of a slide’s notes page; undefined in Master view.

notesText()

A slide’s speaker notes: paragraphs joined with “\r”, line breaks as “\v”.

outline()

Outline View: each slide’s title and body placeholder paragraphs; empty in Master view.

peerView()

Where another writer’s presence lands here; null when its page is gone.

presence()

This writer’s place, for other writers to show.

presentationFonts()

The faces the deck’s text uses, for Replace Fonts’ Replace list.

refresh()

Lays out again each slide an edit or a face the host has fetched since reaches.

selectedSpan()

The selected characters of a shape’s own text (not a table cell’s), as a comment points at them.

selectedText()

The selected text, or the empty string outside text mode.

selectionPane()

The Selection Pane: the slide’s shapes, hidden ones too, front-most first; a group lists its own.

slideObjects()

A slide’s shapes, as the view lists them for the slide on screen.

slideShow()

Every slide as a show plays it, in deck order; hidden slides are listed and marked.

storyText()

The plain text of a story, paragraphs joined with “\r” (PowerPoint’s TextRange).

tableStyles()

Table Design’s style gallery for the selected table: the deck’s styles, then the built-ins, each with a preview.

textFormat()

The laid style where typing would land, the run before the caret; a range shows what all its characters share.

toBytes()

PptxEditorOptions

Headless slide editing over the PowerPoint facade: commands in, a laid-out view out. Import from @reductoai/pptx/editor.