# 幻灯片与版式

- Human documentation: [https://docs.univer.ai/zh-CN/guides/slides/features/core/slides-and-layouts](https://docs.univer.ai/zh-CN/guides/slides/features/core/slides-and-layouts)

- Agent Markdown: [https://docs.univer.ai/zh-CN/guides/slides/features/core/slides-and-layouts.md](https://docs.univer.ai/zh-CN/guides/slides/features/core/slides-and-layouts.md)

- Requested language: `zh-CN`

- Content language: `zh-CN`

- Documentation version: `1.0.0-rc.0`

- Source: [slides/features/core/slides-and-layouts.zh-CN.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/slides/features/core/slides-and-layouts.zh-CN.mdx)

---

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

## 管理幻灯片顺序

```ts
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()` 会通过命令管线删除幻灯片。

## 设置页面尺寸

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

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

## 设置幻灯片背景

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

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