幻灯片与版式

FPresentation 管理幻灯片顺序和共享页面尺寸。FSlide 提供单张幻灯片解析后的页面布局和背景。

管理幻灯片顺序

TypeScript
const presentation = univerAPI.getActivePresentation()if (!presentation) {  throw new Error('No active presentation')}const agenda = presentation.appendSlide({ name: 'Agenda' })const summary = presentation.insertSlide(1, { name: 'Summary' })presentation.moveSlide(summary, 0)presentation.setActiveSlide(agenda)

使用 getSlides()getSlideById()getSlideByIndex() 读取当前顺序。deleteSlide() 会通过命令管线删除幻灯片。

设置页面尺寸

TypeScript
presentation.setPageSize({  preset: univerAPI.Enum.SlidePageSizePresetEnum.WideScreen16By9,})

slide.getPageLayout() 返回解析后的页面尺寸,以及元素边界和顺序。坐标使用 Slides 模型坐标系。

设置幻灯片背景

TypeScript
agenda.setBackground({  type: univerAPI.Enum.SlideBackgroundTypeEnum.Solid,  color: '#1d4ed8',})

传入 undefined 可移除显式背景。setShowMasterBackground(false) 会隐藏该页继承的母版背景图形,而不会从快照中删除它们。

你觉得这篇文档如何?

© 2026 DreamNum Co., Ltd.