页面与元素
创建 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() 删除可编辑元素。删除后不要复用已经失效的包装器。
你觉得这篇文档如何?