Documentation – Изменение полей формы

Python-Net: Добавить элемент списка

Thu, 05 Mar 2026 00:00:00 +0000

Поля списка в PDF позволяют пользователям выбирать одну или несколько опций из предопределённого набора. С помощью Aspose.PDF for Python разработчики могут программно добавлять новые элементы в эти поля. Класс FormEditor предоставляет метод ‘add_list_item’ для добавления элементов в существующее поле списка.

Откройте существующую PDF-форму.
Создайте объект FormEditor.
Привяжите PDF к FormEditor.
Добавьте элементы в поле списка ‘Country’.
Сохраните обновлённый документ.

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

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

from config import set_license, initialize_data_dir


def add_list_item(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Add list item to list box field
    form_editor.add_list_item("Country", ["New Zealand", "New Zealand"])
    # Save updated document
    form_editor.save(outfile)

Python-Net: Скопировать внутреннее поле

Thu, 05 Mar 2026 00:00:00 +0000

PDF-формы часто требуют дублирования полей при сохранении оригинального форматирования и поведения. С помощью Aspose.PDF for Python разработчики могут программно копировать существующее поле в новое положение на той же или другой странице.

В этой статье объясняется, как скопировать поле с именем ‘First Name’ в новое поле под названием ‘First Name Copy’ на странице 2 с конкретными координатами (x=200, y=600), создавая PDF с новым расположенным полем.

Откройте существующую PDF-форму.
Создайте объект FormEditor.
Привяжите PDF‑документ к FormEditor.
Скопируйте поле ‘First Name’ в новое поле ‘First Name Copy’ на странице 2 с координатами (200, 600).
Сохраните обновлённый документ.

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

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

from config import set_license, initialize_data_dir


def copy_inner_field(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Copies an existing field to a new position specified by both page number and ordinates.
    # A new document will be produced, which contains everything the source document has except for the newly copied field.
    form_editor.copy_inner_field("First Name", "First Name Copy", 2, 200, 600)
    # Save updated document
    form_editor.save(outfile)

Обратите внимание:

Подпись метода ‘copy_inner_field’ выглядит так:

copy_inner_field(original_field_name, new_field_name, page_number, x, y)

‘original_field_name’ – поле, которое вы хотите дублировать.
’new_field_name’ – имя нового поля.
‘page_number’ – страница, на которой появится новое поле.
x, y – координаты на этой странице.

Ожидается, что page_number будет положительным целым числом, соответствующим существующей странице в PDF (нумерация с 1).

Если передать отрицательный параметр, например:

form_editor.copy_inner_field("First Name", "First Name Copy", -1, 200, 600)

Программа затем сбросит параметры к предыдущим.

Python-Net: Копировать внешнее поле

Thu, 05 Mar 2026 00:00:00 +0000

Иногда PDF‑формы требуют повторного использования полей из одного документа в другом. С помощью Aspose.PDF for Python разработчики могут программно копировать поля формы из исходного PDF в целевой PDF.

Класс FormEditor предоставляет метод ‘copy_outer_field’, который копирует поле из исходного документа в целевой документ на указанной странице и координатах.

Код создает новый PDF (целевой), добавляет страницу, а затем копирует поле из существующего PDF (исходного) в целевой документ на заданных координатах.

Создайте новый целевой PDF‑документ.
Добавьте как минимум одну страницу в целевой PDF.
Сохраните пустой целевой документ.
Создайте объект FormEditor и привяжите его к целевому PDF.
Скопируйте поле ‘First Name’ из исходного PDF на страницу 1 в координаты (200, 600).
Сохраните обновлённый целевой PDF.

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

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

from config import set_license, initialize_data_dir


def copy_outer_field(infile, outfile):
    # Since copy_outer_field() method needs to copy field from source document to target document, we need to create a new document as target document first.
    doc = ap.Document()
    doc.pages.add()
    doc.save(outfile)

    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(outfile)
    # Copies an existing field to a new position specified by both page number and ordinates.
    # A new document will be produced, which contains everything the source document has except for the newly copied field.
    form_editor.copy_outer_field(infile, "First Name", 1, 200, 600)
    # Save updated document
    form_editor.save(outfile)

Обратите внимание:

Сигнатура метода ‘copy_outer_field’ выглядит так:

copy_outer_field(original_field_name, new_field_name, page_number, x, y)

‘original_field_name’ – поле, которое вы хотите дублировать.
’new_field_name’ – имя нового поля.
‘page_number’ – страница, на которой появится новое поле.
x, y – координаты на этой странице.

Если передать отрицательный параметр, например:

form_editor.copy_outer_field("First Name", "First Name Copy", 1, -200, 600)

Программа затем сбросит параметры к предыдущим.

Python-Net: Удалить элемент списка

Thu, 05 Mar 2026 00:00:00 +0000

Поля списка в PDF позволяют пользователям выбирать один или несколько предопределённых вариантов. С помощью Aspose.PDF for Python разработчики могут программно удалять элементы из этих полей.

В этой статье объясняется, как удалить элемент ‘UK’ из поля списка с именем ‘Country’, гарантируя, что поле содержит только необходимые варианты.

Класс FormEditor предоставляет метод ‘del_list_item’ для удаления конкретного элемента из поля списка.

Откройте существующую PDF-форму.
Создайте объект FormEditor.
Привяжите PDF‑документ к FormEditor.
Удалить элемент ‘UK’ из поля списка ‘Country’.
Сохраните обновлённый документ.

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

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

from config import set_license, initialize_data_dir


def del_list_item(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Delete list item from list box field
    form_editor.del_list_item("Country", "UK")
    # Save updated document
    form_editor.save(outfile)

Python-Net: Переместить поле

Thu, 05 Mar 2026 00:00:00 +0000

PDF‑формы часто требуют корректировки макета после создания. С помощью Aspose.PDF for Python разработчики могут перемещать существующие поля формы в новое положение без их восстановления.

В этом примере показано, как переместить поле “Country”, указав новые координаты его расположения на странице. Класс FormEditor предоставляет метод move_field для перемещения полей внутри страницы PDF.

Откройте существующую PDF-форму.
Создайте объект FormEditor.
Привяжите PDF‑документ к FormEditor.
Переместите поле ‘Country’ в новое положение, используя координаты.
Сохраните изменённый документ.

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

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

from config import set_license, initialize_data_dir


def move_field(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Move field to new page
    form_editor.move_field("Country", 200, 600, 280, 620)
    # Save updated document
    form_editor.save(outfile)

Python-Net: Удалить поле

Thu, 05 Mar 2026 00:00:00 +0000

PDF-формы могут содержать поля, которые больше не нужны из‑за изменений дизайна или обновлений рабочего процесса. С Aspose.PDF for Python разработчики могут легко программно удалять отдельные поля формы.

Класс FormEditor в Aspose.PDF предоставляет метод ‘remove_field’, который позволяет разработчикам удалять поле формы по его имени.

Загрузите PDF‑документ.
Создайте объект FormEditor.
Привяжите PDF к FormEditor.
Удалите указанное поле формы.
Сохраните обновлённый документ.

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

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

from config import set_license, initialize_data_dir


def remove_field(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Remove field from document
    form_editor.remove_field("Country")
    # Save updated document
    form_editor.save(outfile)

Python-Net: Переименовать поле

Thu, 05 Mar 2026 00:00:00 +0000

PDF‑формы часто полагаются на имена полей для скриптов, автоматизации и обработки данных. С помощью Aspose.PDF for Python разработчики могут переименовывать существующие поля без их воссоздания или изменения макета формы.

Класс FormEditor предоставляет метод ‘rename_field’, который позволяет разработчикам изменить имя существующего поля, сохраняя его позицию, значение и внешний вид.

Загрузите существующую PDF-форму.
Создайте экземпляр FormEditor.
Привяжите PDF‑документ к редактору.
Переименуйте целевое поле.
Сохраните обновлённый PDF.

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

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

from config import set_license, initialize_data_dir


def rename_field(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Rename field in document
    form_editor.rename_field("City", "Town")
    # Save updated document
    form_editor.save(outfile)

Python-Net: Однострочное поле в многострочное поле

Thu, 05 Mar 2026 00:00:00 +0000

PDF‑формы иногда содержат текстовые поля, предназначенные для ввода одной строки, что может быть недостаточно для некоторых типов данных. С помощью Aspose.PDF for Python разработчики могут легко преобразовать такие поля в многострочные текстовые поля без их воссоздания.

Используя FormEditor класс, разработчики могут изменять существующие текстовые поля, не влияя на их положение или другие свойства.

Загрузите существующий PDF-документ.
Создайте экземпляр FormEditor.
Привяжите PDF‑документ к редактору.
Преобразовать выбранное поле в многострочное.
Сохраните обновлённый документ.

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

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

from config import set_license, initialize_data_dir


def single2multiple(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Change a single-lined text field to a multiple-lined one
    form_editor.single_2_multiple("City")
    # Save updated document
    form_editor.save(outfile)