Documentation – Вложения

Python-Net: Добавить вложение

Fri, 20 Mar 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: Добавить вложение из пути

Fri, 20 Mar 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: Добавить аннотацию вложения файла

Fri, 20 Mar 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: Добавить аннотацию вложения файла из потока

Fri, 20 Mar 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: Удалить вложения

Fri, 20 Mar 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)