Documentation – Personalizando a aparência do campo

Python-Net: Decorar Campo

Mon, 18 May 2026 00:00:00 +0000

Formulários PDF frequentemente requerem personalização visual para melhorar a usabilidade e criar um design consistente. Com Aspose.PDF for Python, os desenvolvedores podem decorar programaticamente campos de formulário definindo propriedades como cores, bordas e alinhamento de texto.

Usando o FormEditor e FormFieldFacade classes que os desenvolvedores podem modificar facilmente a aparência dos campos de formulário para melhorar a legibilidade, destacar campos obrigatórios ou atender aos requisitos de marca.

Abra um documento PDF existente.
Crie um objeto FormEditor para manipular campos de formulário.
Defina o estilo visual usando FormFieldFacade.
Aplique a estilização a um campo de formulário específico.
Salve o documento atualizado.

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: Obter Aparência do Campo

Mon, 18 May 2026 00:00:00 +0000

Campos de formulário em documentos PDF possuem propriedades visuais como cor de fundo, cor do texto, cor da borda e alinhamento. Com Aspose.PDF for Python, os desenvolvedores podem inspecionar programaticamente essas configurações de aparência usando o FormEditor classe.

Abra um documento PDF existente.
Crie um objeto FormEditor.
Recupere as informações de aparência de um campo específico.

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: Definir Alinhamento de Campo

Mon, 18 May 2026 00:00:00 +0000

Os campos de formulário PDF frequentemente requerem alinhamento de texto personalizado para manter um layout consistente e profissional. Usando Aspose.PDF for Python, os desenvolvedores podem definir programaticamente o alinhamento do conteúdo de texto de um campo de formulário\u2019s.

O FormEditor classe, em combinação com o FormFieldFacade constants, permite que os desenvolvedores modifiquem o alinhamento dos campos de formulário existentes programaticamente.

Abra um documento PDF existente.
Crie um objeto FormEditor.
Defina o alinhamento de um campo chamado “First Name” para o centro.
Salve o documento modificado.

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: Definir Alinhamento Vertical do Campo

Mon, 18 May 2026 00:00:00 +0000

Os campos de formulário PDF podem conter texto que necessita de alinhamento vertical adequado para uma aparência consistente e profissional. Usando Aspose.PDF for Python, os desenvolvedores podem modificar programaticamente o alinhamento vertical dos campos de formulário. O alinhamento vertical permite que os desenvolvedores controlem se o texto do campo aparece na parte superior, central ou inferior da caixa delimitadora do campo, melhorando o layout e a legibilidade dos dados do formulário.

Usando o FormEditor classe e o FormFieldFacade constantes, os desenvolvedores podem ajustar o alinhamento vertical programaticamente para obter um layout de formulário consistente:

Abra um documento PDF existente.
Crie um objeto FormEditor.
Defina o alinhamento vertical de um campo chamado “First Name” para a parte inferior.
Salve o documento modificado.

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: Definir Aparência do Campo

Mon, 18 May 2026 00:00:00 +0000

Os campos de formulário PDF suportam flags de aparência que controlam visibilidade, capacidade de impressão e interatividade. Usando Aspose.PDF for Python, os desenvolvedores podem modificar programaticamente essas flags para campos de formulário específicos.

Usando o FormEditor classe, os desenvolvedores podem modificar essas flags para ocultar, exibir ou personalizar o comportamento dos campos de formulário em um PDF interativo.

Abra um documento PDF existente.
Crie um objeto FormEditor.
Defina a aparência do campo chamado “First Name” como invisível.
Salve o documento atualizado.

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: Definir número de comb do campo

Mon, 18 May 2026 00:00:00 +0000

O número de comb define como o conteúdo do campo é dividido em caixas igualmente espaçadas, frequentemente usado para códigos PIN, números de série ou outros campos de entrada de comprimento fixo. O código abre um PDF existente, define o número de comb para um campo e salva o documento modificado.

O FormEditor A classe fornece o método ‘set_field_comb_number’ para definir o número de caixas (caracteres) em um campo de formulário.

Abra um formulário PDF existente.
Cria um objeto FormEditor.
Define o número de comb de um campo chamado “PIN” para 5.
Salve o documento atualizado.

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: Definir Limite de Campo

Mon, 18 May 2026 00:00:00 +0000

Campos de formulário em documentos PDF podem exigir restrições de entrada para manter a formatação adequada. Usando Aspose.PDF for Python, os desenvolvedores podem programaticamente definir um número máximo de caracteres para um campo.

O FormEditor a classe fornece o método ‘set_field_limit’ para definir o comprimento máximo de entrada para um campo.

Abra um formulário PDF existente.
Crie um objeto FormEditor.
Defina o limite máximo de caracteres para o campo “Last Name”.
Salve o PDF atualizado.

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)