使用 Python 電子簽署文件的完整指南：簡單的印章、圖像和表單字段數字簽名

pip install groupdocs-signature-net

# 導入核心 GroupDocs.Signature 庫
import groupdocs.signature as gs

# 導入用於配置簽名設置的選項
import groupdocs.signature.options as gso

# 導入用於簽名自定義的域類
import groupdocs.signature.domain as gsd

# 此函數演示如何將文本表單字段簽名添加到 PDF
# 表單字段創建互動區域，用戶可以在其中輸入簽名信息
def add_form_field_signature():
    # 定義源文件和輸出文件的路徑
    sample_pdf = "sample.pdf"               # 您的源 PDF 文件
    output_file_path = "form_signed.pdf"    # 保存簽署文件的位置

    # 打開文件以簽署
    with gs.Signature(sample_pdf) as signature:
        # 創建具有字段名稱和默認值的文本表單字段簽名
        # 字段名稱是標識符，而值是默認文本
        text_signature = gs.domain.TextFormFieldSignature("SignatureField", "Sign here")

        # 根據文本簽名配置表單字段選項
        options = gso.FormFieldSignOptions(text_signature)

        # 設置表單字段的位置和大小
        options.top = 150                   # 頁面上的 Y 位置
        options.left = 50                   # 頁面上的 X 位置
        options.height = 50                 # 字段的高度
        options.width = 200                 # 字段的寬度

        # 簽署文件（添加表單字段）並保存到文件
        result = signature.sign(output_file_path, options)

        # 顯示成功消息，並分開記錄條目
        print(f"\n表單字段簽名添加成功。")
        print(f"總表單字段添加：{len(result.succeeded)}")
        print(f"文件保存於 {output_file_path}。")

# 此函數顯示如何將基於圖像的簽名添加到文件中
# 適合添加手寫簽名、公司標誌或官方印章
def add_image_signature():
    # 定義文件路徑
    sample_file_path = "sample.pdf"         # 您的源文件
    image_signature = "signature.png"       # 您的簽名圖像文件
    output_file_path = "image_signed.pdf"   # 保存簽署文件的位置

    # 打開文件以簽署
    with gs.Signature(sample_file_path) as signature:
        # 使用簽名圖像路徑配置圖像簽名選項
        options = gso.ImageSignOptions(image_signature)

        # 設置圖像簽名的位置
        options.left = 50                   # 頁面上的 X 位置
        options.top = 50                    # 頁面上的 Y 位置

        # 將其應用於文件中的所有頁面
        options.all_pages = True

        # 使用圖像簽署文件並保存到文件
        result = signature.sign(output_file_path, options)

        # 顯示成功消息，並分開記錄條目
        print(f"\n圖像簽名應用成功。")
        print(f"總簽名應用：{len(result.succeeded)}")
        print(f"簽署文件保存於 {output_file_path}。")

# 此函數演示如何添加官方外觀的印章簽名
# 適合創建公證式印章、公司印章或批准標記
def add_stamp_signature():
    # 導入所需的庫
    import groupdocs.signature as gs
    import groupdocs.signature.domain as gsd
    import groupdocs.signature.options as gso

    # 定義文件路徑
    sample_file_path = "sample.pdf"         # 您的源文件
    output_file_path = "stamp_signed.pdf"   # 保存簽署文件的位置

    # 打開文件以簽署
    with gs.Signature(sample_file_path) as signature:
        # 定義印章簽名選項
        options = gso.StampSignOptions()

        # 設置印章的位置和大小
        options.left = 50                   # 頁面上的 X 位置
        options.top = 150                   # 頁面上的 Y 位置
        options.width = 200                 # 印章的寬度
        options.height = 200                # 印章的高度

        # 創建印章的外圓形文本行
        # 這將在印章外圍創建文本環
        outer_line = gsd.StampLine()
        outer_line.text = " * 官方文件 * "  # 用星號裝飾的文本
        outer_line.text_repeat_type = gsd.StampTextRepeatType.FULL_TEXT_REPEAT  # 重複文本環
        outer_line.font = gsd.SignatureFont()         # 配置字體
        outer_line.height = 22                        # 文本行的高度
        outer_line.text_bottom_intent = 6             # 從底部的間距
        options.outer_lines.append(outer_line)        # 添加到印章選項

        # 創建印章的內部文本行（中心文本）
        # 這將在印章中間創建內容
        inner_line = gsd.StampLine()
        inner_line.text = "已批准"                  # 印章的中心文本
        inner_line.font = gsd.SignatureFont()         # 配置字體
        inner_line.font.bold = True                   # 使文本粗體
        inner_line.height = 40                        # 文本行的高度
        options.inner_lines.append(inner_line)        # 添加到印章選項

        # 可選：添加更多內部行，包含其他信息
        date_line = gsd.StampLine()
        date_line.text = "2025 年 5 月 13 日"               # 批准日期
        date_line.height = 20                         # 文本行的高度
        options.inner_lines.append(date_line)         # 添加到印章選項

        # 應用簽名並保存文件
        result = signature.sign(output_file_path, options)

        # 顯示成功消息，並分開記錄條目
        print(f"\n印章簽名應用成功。")
        print(f"總簽名應用：{len(result.succeeded)}")
        print(f"文件保存於 {output_file_path}。")