使用Python實現向同一PDF添加附件與附件注釋

更新時間：2025年11月03日 09:07:10 作者：Eiceblue

在文檔管理和報表生成中,將相關文件直接嵌入 PDF 可以大大提高信息整合度,讓收件人無需額外查找即可訪問所有資源,本文演示如何在同一 PDF 文件中實現直接添加附件和添加附件注釋,希望對大家有所幫助

1. 初始化 PDF 文檔

from spire.pdf import *
from spire.pdf.common import *

# PdfDocument 對象創(chuàng)建
doc = PdfDocument()

# 加載已有 PDF 文件
doc.LoadFromFile("Sample.pdf")

操作說明：

PdfDocument 是 Spire.PDF 的核心類，用于表示和操作 PDF 文檔。
LoadFromFile() 可以加載已有 PDF，后續(xù)的附件操作都基于這個文檔進行。

2. 添加外部文件作為 PDF 附件

# 創(chuàng)建 PdfAttachment 對象
attachment_one = PdfAttachment("Antivirus Software.pdf")
attachment_two = PdfAttachment("Steps for Backup.png")

# 將附件添加到 PDF
doc.Attachments.Add(attachment_one)
doc.Attachments.Add(attachment_two)

# 保存文件
doc.SaveToFile("output/DocumentAttachment.pdf")

使用說明：

PdfAttachment 用于封裝需要添加的文件，包括 Excel、圖片或其他文檔。
Attachments.Add() 將附件嵌入 PDF，使所有相關文件集中在同一個 PDF 內。
保存后，收件人可在 PDF 閱讀器中直接查看或提取這些附件。

效果展示：

適用場景：

發(fā)票或報表需要附帶原始數據文件。
項目文檔需要附帶圖紙、圖片或說明文件。
任何需要將多種資源整合到單一 PDF 的場景。

3. 在 PDF 頁面添加附件注釋

# 獲取特定頁面
page = doc.Pages[1]

# 繪制文本
str = "This is the document: "
font = PdfTrueTypeFont("Yu Gothic UI", 16.0, PdfFontStyle.Bold, True)
x = 50.0
y = doc.Pages[0].ActualSize.Height - 30.0
page.Canvas.DrawString(str, font, PdfBrushes.get_Blue(), x, y)

# 創(chuàng)建 PdfAttachmentAnnotation
data = Stream("G:/Documents/Update System.docx")
size = font.MeasureString(str)
bounds = RectangleF((x + size.Width + 5.0), y, 10.0, 15.0)
annotation = PdfAttachmentAnnotation(bounds, "Update System.docx", data)

# 設置注釋屬性
annotation.Color = PdfRGBColor(Color.get_Blue())
annotation.Flags = PdfAnnotationFlags.Default
annotation.Icon = PdfAttachmentIcon.Graph
annotation.Text = "Click to open"

# 添加到 PDF 頁面
page.AnnotationsWidget.Add(annotation)

# 保存文件
doc.SaveToFile("output/AnnotationAttachment.pdf")

操作說明：

PdfAttachmentAnnotation 可以在 PDF 頁面上顯示附件圖標，用戶點擊即可打開附件。
bounds 定義注釋的位置和大小。
Color、Icon 和 Text 用于美化和提示操作。
AnnotationsWidget.Add() 將注釋添加到頁面上。

效果展示：

適用場景：

報告正文中嵌入支持文件，讓讀者點擊即可獲取。
教學或培訓資料中附加示例文件。
需要對附件做視覺提示而非僅僅嵌入 PDF 時。

4. 總結

通過上述操作，開發(fā)者可以輕松實現：

功能類型	關鍵類/方法	使用說明
添加附件	PdfAttachment、Attachments.Add()	將外部文件直接嵌入 PDF
添加附件注釋	PdfAttachmentAnnotation、AnnotationsWidget.Add()	在頁面上顯示附件圖標并可點擊打開
設置字體與顏色	PdfTrueTypeFont、PdfBrushes	為頁面文本提供美觀的顯示
保存 PDF	SaveToFile()	保存修改后的 PDF 文件