页面与元素

创建 PDF 页面、枚举可编辑元素,并控制元素几何与层叠顺序。

FPdf 拥有页面;每个 FPdfPage 提供放置在该页上的持久化可编辑叠加层。

读取与插入页面

页面索引从 0 开始。insertPage(index?) 可在指定索引插入页面;省略索引时追加页面。空文档使用 A4 尺寸。

TypeScript
const pdf = univerAPI.getActivePdf()if (!pdf) {  throw new Error('No active PDF')}const page = pdf.getPageByIndex(0) ?? pdf.insertPage()const pages = pdf.getPages()const samePage = pdf.getPageById(page.getId())

枚举可编辑元素

getElements() 按 z 顺序返回可编辑叠加层,不包含导入 PDF 中的原生对象。

TypeScript
const elements = page.getElements()const [firstElement] = elementsconst sameElement = firstElement ? page.getElementById(firstElement.getId()) : null

需要专用包装器时,请使用类型化 getter:getTextBoxes()getParagraphs()getLists()getTables()getImages()getDividers()getAnnotations()

变换与移除元素

Facade 放置值使用 PDF 点。getData() 返回的快照几何使用核心 PDF 单位,因此应通过 Facade 方法更新放置。

TypeScript
const [element] = page.getElements()if (element) {  element    .setPosition(36, 72)    .setSize(288, 144)    .setRotation(5)    .setVisible(true)    .setLocked(false)    .bringToFront()}

使用 remove() 删除可编辑元素。删除后请勿复用已失效的包装器。

你觉得这篇文档如何?

© 2026 DreamNum Co., Ltd.