Class: NotesSlide

A slide's speaker-notes slide (notesSlideN.xml) as a modeled object — the deep companion to Slide.notesText. Exposes the notes shape tree as NotesPlaceholders (body/slideImage/ slideNumber) plus the body textFrame the older getters flatten.

The theme context (notesMaster → theme2.xml) is resolved once and shared across every placeholder's text frame.

Implements

• ShapeHost

Constructors

Constructor

new NotesSlide(opc, part): NotesSlide

Parameters

Parameter	Type	Description
opc	OpcPackage	The package the notes slide belongs to, for reaching the notesMaster and its theme.
part	Part	The notes slide's OPC part (/ppt/notesSlides/notesSlideN.xml).

Returns

NotesSlide

Properties

opc

readonly opc: OpcPackage

The package the notes slide belongs to, for reaching the notesMaster and its theme.

Implementation of

ShapeHost.opc

---

part

readonly part: Part

The notes slide's OPC part (/ppt/notesSlides/notesSlideN.xml).

Implementation of

ShapeHost.part

Accessors

body

Get Signature

get body(): NotesPlaceholder | null

The notes body placeholder (p:ph type="body"), or null when the notes slide has none.

Returns

NotesPlaceholder | null

---

partName

Get Signature

get partName(): string

Partname of the notes slide part.

Returns

string

Partname of part.

Implementation of

ShapeHost.partName

---

placeholders

Get Signature

get placeholders(): NotesPlaceholder[]

The placeholders (p:sp) in the notes shape tree, in document order.

Returns

NotesPlaceholder[]

---

relationships

Get Signature

get relationships(): Relationships

The notes part's own relationships — a notes hyperlink resolves through these.

Returns

Relationships

part's relationships — image embeds, hyperlinks, chart references.

Implementation of

ShapeHost.relationships

---

shapes

Get Signature

get shapes(): AnyShape[]

The notes shape tree as full shapes, in document order.

A notes slide holds nothing but its three placeholders, so placeholders is the view to read. This one exists because a notes slide is a ShapeHost — which is what lets a NotesPlaceholder be the same AutoShape view of its p:sp that a master or layout placeholder is, rather than a second reading of one.

Returns

AnyShape[]

---

slideImage

Get Signature

get slideImage(): NotesPlaceholder | null

The slide-thumbnail placeholder (p:ph type="sldImg"), or null when absent.

Returns

NotesPlaceholder | null

---

slideNumber

Get Signature

get slideNumber(): NotesPlaceholder | null

The slide-number placeholder (p:ph type="sldNum", carrying the slide-number field), or null.

Returns

NotesPlaceholder | null

---

text

Get Signature

get text(): string

The notes body text flattened (paragraphs joined by \n), or '' when the body is empty/absent.

Returns

string

---

textFrame

Get Signature

get textFrame(): TextFrame | null

The notes body as a navigable TextFrame, or null when there is no body text frame.

Returns

TextFrame | null

Methods

shapeByIdDeep()

shapeByIdDeep(id): AnyShape | undefined

The shape anywhere in the notes tree with the given drawing id, or undefined.

Parameters

Parameter	Type
id	number

Returns

AnyShape | undefined

Implementation of

ShapeHost.shapeByIdDeep

---

themeContext()

themeContext(): ThemeContext

The notes theme context, resolved through the notesMaster → theme2.xml chain and cached. Backs NotesPlaceholder.textFrame's Run.resolvedColor.

Returns

ThemeContext

Implementation of

ShapeHost.themeContext