Documentation – 附件

Python-Net: 添加附件

Mon, 08 Jun 2026 00:00:00 +0000

PDF 中的文件附件允许您直接在 PDF 中包含补充的文档、图像或其他资源。使用 PdfContentEditor, 您可以以编程方式将文件附加到特定页面，设置附件名称并提供描述。

创建 PdfContentEditor 对象。
绑定输入 PDF。
打开附件文件。
将附件添加到 PDF 中。
保存已更新的 Document。

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_attachment(infile, attachment_file, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add attachment to page 1
    with open(attachment_file, "rb") as attachment_stream:
        content_editor.add_document_attachment(
            attachment_stream,
            path.basename(attachment_file),
            "This is a sample attachment for demonstration purposes.",
        )
    # Save updated document
    content_editor.save(outfile)

Python-Net: 从路径添加附件

Mon, 08 Jun 2026 00:00:00 +0000

PDF 可以包含嵌入的文件，例如文档、电子表格或图像，以供参考或分发。‘add_document_attachment()’ 的文件路径重载允许您直接从文件路径添加附件，消除手动打开文件的需求。

创建 PdfContentEditor 对象。
绑定输入 PDF。
使用文件路径添加附件。
保存已更新的 Document。

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_attachment_from_path(infile, attachment_file, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Add attachment using file-path overload
    content_editor.add_document_attachment(
        attachment_file,
        "Attachment added using file path overload.",
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: 添加文件附件注释

Mon, 08 Jun 2026 00:00:00 +0000

文件附件注释允许您将外部文件嵌入为 PDF 页面上的交互式图标。使用文件路径重载，您可以直接从磁盘附加文件，而无需手动打开流。此方法还允许您自定义注释图标并为用户提供描述。

创建 PdfContentEditor 对象。
绑定输入 PDF。
定义注释矩形。
添加文件附件注释。
保存已更新的 Document。

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_file_attachment_annotation(infile, attachment_file, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Create file attachment annotation on page 1
    content_editor.create_file_attachment(
        apd.Rectangle(100, 520, 20, 20),
        "Attachment annotation contents",
        attachment_file,
        1,
        "PushPin",
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: 从流添加文件附件注释

Mon, 08 Jun 2026 00:00:00 +0000

文件附件注释允许将文件嵌入为 PDF 页面内的交互式图标。使用基于流的方法，您可以在不依赖物理文件路径的情况下动态附加文件。此方法还支持自定义注释的外观，包括不透明度。

创建 PdfContentEditor 对象。
绑定输入 PDF。
将附件文件读取为流。
添加文件附件注释。
保存已更新的 Document。

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def add_file_attachment_annotation_from_stream(infile, attachment_file, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    with open(attachment_file, "rb") as source_stream:
        attachment_stream = BytesIO(source_stream.read())

    # Create file attachment annotation using stream+opacity overload
    content_editor.create_file_attachment(
        apd.Rectangle(130, 520, 20, 20),
        "Attachment annotation from stream",
        attachment_stream,
        path.basename(attachment_file),
        1,
        "Tag",
        0.75,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: 删除附件

Mon, 08 Jun 2026 00:00:00 +0000

PDF 可能包含文档、图像或其他文件等附件。在出于安全、隐私或分发目的需要清除 PDF 中所有附件的场景中。使用 PdfContentEditor，您可以以编程方式删除文档中所有嵌入的附件。

创建 PdfContentEditor 对象。
绑定输入 PDF。
删除所有附件。
保存已更新的 Document。

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def remove_attachments(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Remove all attachments from document
    content_editor.delete_attachments()
    # Save updated document
    content_editor.save(outfile)