页面与元素

创建 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.