頁面與元素

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