Documentation – Modificando Campos de Formulário

Python-Net: Adicionar item à lista

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

Os campos de caixa de lista em PDFs permitem que os usuários selecionem uma ou várias opções de um conjunto predefinido. Usando Aspose.PDF for Python, os desenvolvedores podem adicionar programaticamente novos itens a esses campos. The FormEditor A classe fornece o método ‘add_list_item’ para acrescentar itens a um campo de caixa de lista existente.

Abra um formulário PDF existente.
Crie um objeto FormEditor.
Vincule o PDF ao FormEditor.
Adicione itens ao campo de caixa de lista “Country”.
Salve o documento atualizado.

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: Copiar Campo Interno

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

Os formulários PDF geralmente exigem a duplicação de campos mantendo a formatação e o comportamento originais. Usando Aspose.PDF for Python, os desenvolvedores podem copiar um campo existente para uma nova posição na mesma página ou em outra página programaticamente.

Este artigo explica como copiar um campo chamado ‘First Name’ para um novo campo chamado ‘First Name Copy’ na página 2 em coordenadas específicas (x=200, y=600), produzindo um PDF com o campo recém‑posicionado.

Abra um formulário PDF existente.
Crie um objeto FormEditor.
Vincule o documento PDF ao FormEditor.
Copie o campo ‘First Name’ para um novo campo ‘First Name Copy’ na página 2 nas coordenadas (200, 600).
Salve o documento atualizado.

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)

Por favor, note:

A assinatura do método ‘copy_inner_field’ é a seguinte:

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

‘original_field_name’ – o campo que você deseja duplicar.
’new_field_name’ – o nome do novo campo.
‘page_number’ – a página na qual o novo campo aparecerá.
x, y – coordenadas nessa página.

O page_number deve ser um número inteiro positivo correspondente a uma página existente no PDF (indexação a partir de 1).

Se você passar um parâmetro negativo, por exemplo:

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

O programa então redefinirá para os parâmetros anteriores.

Python-Net: Copiar Campo Externo

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

Às vezes, os formulários PDF exigem reutilizar campos de um documento em outro. Usando Aspose.PDF for Python, os desenvolvedores podem copiar programaticamente campos de formulário de um PDF de origem para um PDF de destino.

O FormEditor a classe fornece o método ‘copy_outer_field’, que copia um campo de um documento de origem para um documento de destino em uma página e coordenadas especificadas.

O código cria um novo PDF (destino), adiciona uma página e, em seguida, copia um campo de um PDF existente (origem) para o documento de destino nas coordenadas especificadas.

Crie um novo documento PDF de destino.
Adicione pelo menos uma página ao PDF de destino.
Salve o documento de destino vazio.
Crie um objeto FormEditor e vincule‑o ao PDF de destino.
Copie o campo ‘First Name’ do PDF de origem para a página 1 em (200, 600).
Salve o PDF de destino atualizado.

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)

Por favor, note:

A assinatura do método ‘copy_outer_field’ é a seguinte:

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

‘original_field_name’ – o campo que você deseja duplicar.
’new_field_name’ – o nome do novo campo.
‘page_number’ – a página na qual o novo campo aparecerá.
x, y – coordenadas nessa página.

O page_number deve ser um número inteiro positivo correspondente a uma página existente no PDF (indexação a partir de 1).

Se você passar um parâmetro negativo, por exemplo:

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

O programa então redefinirá para os parâmetros anteriores.

Python-Net: Excluir item da lista

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

Campos de caixa de lista em PDFs permitem que os usuários selecionem uma ou várias opções predefinidas. Usando Aspose.PDF for Python, os desenvolvedores podem remover itens desses campos programaticamente.

Este artigo explica como excluir o item ‘UK’ de um campo de caixa de lista chamado ‘Country’, garantindo que o campo contenha apenas as opções desejadas.

O FormEditor A classe fornece o método ‘del_list_item’ para remover um item específico de um campo de caixa de lista.

Abra um formulário PDF existente.
Crie um objeto FormEditor.
Vincule o documento PDF ao FormEditor.
Excluir o item “UK” da caixa de listagem “Country”.
Salve o documento atualizado.

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: Mover Campo

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

Os formulários PDF frequentemente requerem ajustes de layout após a criação. Usando Aspose.PDF for Python, os desenvolvedores podem mover campos de formulário existentes para uma nova posição sem recriá‑los.

Este exemplo mostra como reposicionar o campo "Country" especificando novas coordenadas para sua colocação dentro da página. O FormEditor classe fornece o método move_field para realocar campos dentro de uma página PDF.

Abra o formulário PDF existente.
Crie um objeto FormEditor.
Vincule o documento PDF ao FormEditor.
Mova o campo ‘Country’ para uma nova posição usando coordenadas.
Salve o documento modificado.

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: Remover Campo

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

Formulários PDF podem conter campos que não são mais necessários devido a mudanças de design ou atualizações de fluxo de trabalho. Com Aspose.PDF for Python, os desenvolvedores podem remover facilmente campos de formulário específicos programaticamente.

O FormEditor A classe em Aspose.PDF fornece o método ‘remove_field’, que permite aos desenvolvedores excluir um campo de formulário pelo seu nome.

Carregue o documento PDF.
Crie um objeto FormEditor.
Vincule o PDF ao FormEditor.
Remova o campo de formulário especificado.
Salve o documento atualizado.

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: Renomear Campo

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

Os formulários PDF geralmente dependem dos nomes dos campos para scripts, automação e processamento de dados. Usando Aspose.PDF for Python, os desenvolvedores podem renomear campos existentes sem recriá‑los ou alterar o layout do formulário.

O FormEditor a classe fornece o método ‘rename_field’, que permite aos desenvolvedores alterar o nome de um campo existente enquanto preserva sua posição, valor e aparência.

Carregue o formulário PDF existente.
Crie uma instância de FormEditor.
Vincule o documento PDF ao editor.
Renomeie o campo alvo.
Salve o PDF atualizado.

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: Campo de linha única para campo de múltiplas linhas

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

Formulários PDF às vezes contêm campos de texto projetados para entrada de linha única, o que pode não ser suficiente para certos tipos de dados. Com Aspose.PDF for Python, os desenvolvedores podem converter facilmente esses campos em campos de texto de múltiplas linhas sem precisar recriá-los.

Usando o FormEditor class, os desenvolvedores podem modificar campos de texto existentes sem afetar sua posição ou outras propriedades.

Carregue o documento PDF existente.
Crie uma instância de FormEditor.
Vincule o documento PDF ao editor.
Converta o campo selecionado para várias linhas.
Salve o documento atualizado.

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)