Documentation – Настройка внешнего вида полей

Python-Net: Украсьте поле

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

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

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

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

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

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

from config import set_license, initialize_data_dir


def decorate_field(infile, outfile):
    # Open document
    doc = ap.Document(infile)

    # Create FormEditor object
    form_editor = pdf_facades.FormEditor(doc)
    form_editor.facade = pdf_facades.FormFieldFacade()
    form_editor.facade.background_color = ap_pydrawing.Color.red
    form_editor.facade.text_color = ap_pydrawing.Color.blue
    form_editor.facade.border_color = ap_pydrawing.Color.green
    form_editor.facade.alignment = pdf_facades.FormFieldFacade.ALIGN_CENTER
    form_editor.decorate_field("First Name")

    # 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.
Получите информацию о внешнем виде конкретного поля.

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

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

from config import set_license, initialize_data_dir


def get_field_appearance(infile, outfile):
    # Open document
    doc = ap.Document(infile)

    # Create FormEditor object
    form_editor = pdf_facades.FormEditor(doc)

    # Get field appearance
    appearance = form_editor.get_field_appearance("Last Name")
    print("Field Appearance: " + str(appearance))

Python-Net: Установить выравнивание поля

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

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

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

Откройте существующий PDF‑документ.
Создать объект FormEditor.
Установите выравнивание поля с именем ‘First Name’ по центру.
Сохраните изменённый документ.

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

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

from config import set_license, initialize_data_dir


def set_field_alignment(infile, outfile):
    # Open document
    doc = ap.Document(infile)

    # Create FormEditor object
    form_editor = pdf_facades.FormEditor(doc)

    # Set field alignment to center
    if form_editor.set_field_alignment(
        "First Name", pdf_facades.FormFieldFacade.ALIGN_CENTER
    ):
        # Save updated document
        form_editor.save(outfile)
    else:
        raise Exception(
            "Failed to set field alignment. Field may not support alignment."
        )

Python-Net: Установить вертикальное выравнивание поля

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

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

Используя FormEditor класс и FormFieldFacade константы, разработчики могут программно регулировать вертикальное выравнивание, чтобы достичь согласованного расположения формы:

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

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

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

from config import set_license, initialize_data_dir


def set_field_alignment_vertical(infile, outfile):
    # Open document
    doc = ap.Document(infile)

    # Create FormEditor object
    form_editor = pdf_facades.FormEditor(doc)

    # Attempt to set vertical alignment of the "First Name" field to bottom
    if form_editor.set_field_alignment_v(
        "First Name", pdf_facades.FormFieldFacade.ALIGN_BOTTOM
    ):
        # Save updated document
        form_editor.save(outfile)
    else:
        raise Exception(
            "Failed to set field vertical alignment. Field may not support vertical alignment."
        )

Python-Net: Установить внешний вид поля

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

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

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

Откройте существующий PDF‑документ.
Создайте объект FormEditor.
Установите внешний вид поля с именем ‘First Name’ в невидимое.
Сохраните обновлённый документ.

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

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

from config import set_license, initialize_data_dir


def set_field_appearance(infile, outfile):
    # Open document
    doc = ap.Document(infile)

    # Create FormEditor object
    form_editor = pdf_facades.FormEditor(doc)

    # Set field appearance to invisible
    if not form_editor.set_field_appearance(
        "First Name", ap.annotations.AnnotationFlags.INVISIBLE
    ):
        raise Exception(
            "Failed to set field appearance. Field may not support appearance flags."
        )

    # Save updated document
    form_editor.save(outfile)

Python-Net: Установить количество ячеек поля

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

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

Класс FormEditor предоставляет метод ‘set_field_comb_number’, позволяющий задать количество ячеек (символов) в поле формы.

Откройте существующую PDF-форму.
Создайте объект FormEditor.
Установите число comb поля с именем “PIN” равным 5.
Сохраните обновлённый документ.

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

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

from config import set_license, initialize_data_dir


def set_field_comb_number(infile, outfile):
    # Open document
    doc = ap.Document(infile)

    # Create FormEditor object
    form_editor = pdf_facades.FormEditor(doc)

    # Set field comb number to 5
    form_editor.set_field_comb_number("PIN", 5)

    # Save updated document
    form_editor.save(outfile)

Python-Net: Установить ограничение поля

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

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

Класс FormEditor предоставляет метод ‘set_field_limit’ для определения максимальной длины ввода для поля.

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

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

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

from config import set_license, initialize_data_dir


def set_field_limit(infile, outfile):
    # Open document
    doc = ap.Document(infile)

    # Create FormEditor object
    form_editor = pdf_facades.FormEditor(doc)

    # Set field limit to 10
    if not form_editor.set_field_limit("Last Name", 10):
        raise Exception(
            "Failed to set field limit. Field may not support specified limit."
        )

    # Save updated document
    form_editor.save(outfile)