Documentation – Operações de Texto

Python-Net: Substituir Texto na Página

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

A substituição de texto é uma necessidade comum ao atualizar documentos PDF. Usando PdfContentEditor, você pode pesquisar texto específico e substituí-lo por novo conteúdo. A propriedade ‘replace_text_strategy’ permite controlar quantas ocorrências são substituídas.

Crie uma instância de PdfContentEditor.
Vincule o documento PDF de entrada.
Configure a estratégia de substituição de texto.
Substitua o texto alvo.
Salve o documento PDF atualizado.

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

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

from config import set_license, initialize_data_dir


def replace_text_on_page(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Replace text on page 1
    content_editor.replace_text_strategy.replace_scope = (
        pdf_facades.ReplaceTextStrategy.Scope.REPLACE_FIRST
    )
    content_editor.replace_text("PDF", "Page 1 Replaced Text", 14)
    # Save updated document
    content_editor.save(outfile)

Python-Net: Substituir Texto na Página com Estado

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

Às vezes, substituir texto em um PDF também requer alterações de formatação, como cor ou tamanho da fonte. Usando TextState, você pode definir propriedades de estilo e aplicá-las durante a substituição. Isso permite realçar o texto modificado ou impor formatação consistente em todos os documentos.

Criar um PdfContentEditor instância.
Vincule o documento PDF de entrada.
Defina um TextState com formatação personalizada.
Configure a estratégia de substituição.
Substitua texto em uma página específica.
Salve o documento PDF atualizado.

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

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

from config import set_license, initialize_data_dir


def replace_text_on_page_with_state(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    text_state = ap.text.TextState()
    text_state.foreground_color = ap.Color.red
    text_state.font_size = 12

    # Replace text on a specific page with explicit text formatting
    content_editor.replace_text_strategy.replace_scope = (
        pdf_facades.ReplaceTextStrategy.Scope.REPLACE_ALL
    )
    content_editor.replace_text("software", 1, "SOFTWARE PAGE 1", text_state)
    # Save updated document
    content_editor.save(outfile)

Python-Net: Substituir Texto com Regex

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

Expressões regulares permitem substituição flexível de texto baseada em padrões em vez de cadeias fixas. Ao habilitar o suporte a regex em ‘replace_text_strategy’, você pode corresponder conteúdo dinâmico, como números, datas ou strings formatadas.

Criar um PdfContentEditor instância.
Vincule o documento PDF de entrada.
Configure a estratégia de substituição para usar regex.
Substitua padrões correspondentes em todo o documento.
Salve o documento PDF atualizado.

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

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

from config import set_license, initialize_data_dir


def replace_text_regex(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Replace text in the whole document
    content_editor.replace_text_strategy.replace_scope = (
        pdf_facades.ReplaceTextStrategy.Scope.REPLACE_ALL
    )
    content_editor.replace_text_strategy.is_regular_expression_used = True
    content_editor.replace_text(r"\d{4}", "[NUMBER]")
    # Save updated document
    content_editor.save(outfile)

Python-Net: Substituir Texto Simples

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

A substituição simples de texto é útil ao atualizar valores repetidos em um documento. Com PdfContentEditor, você pode definir um escopo de substituição e substituir o texto globalmente em todas as páginas.

Criar um PdfContentEditor instância.
Vincule o documento PDF de entrada.
Configure o escopo de substituição para todas as ocorrências.
Substitua o texto alvo.
Salve o documento PDF atualizado.

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

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

from config import set_license, initialize_data_dir


def replace_text_simple(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Replace text in the whole document
    content_editor.replace_text_strategy.replace_scope = (
        pdf_facades.ReplaceTextStrategy.Scope.REPLACE_ALL
    )
    content_editor.replace_text("33", "XXXIII ")
    # Save updated document
    content_editor.save(outfile)

Python-Net: Substituir Texto com Estado

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

Ao atualizar texto em um PDF, você pode querer que o conteúdo substituído se destaque. Usando um objeto TextState, você pode definir estilo como cor e tamanho da fonte, e então aplicá-lo a todo o texto substituído.

Criar um PdfContentEditor instância.
Vincule o documento PDF de entrada.
Defina um TextState com formatação personalizada.
Configurar escopo de substituição.
Substituir texto em todo o documento.
Salve o documento PDF atualizado.

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

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

from config import set_license, initialize_data_dir


def replace_text_with_state(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    text_state = ap.text.TextState()
    text_state.foreground_color = ap.Color.blue
    text_state.font_size = 14

    # Replace text with explicit text formatting
    content_editor.replace_text_strategy.replace_scope = (
        pdf_facades.ReplaceTextStrategy.Scope.REPLACE_ALL
    )
    content_editor.replace_text("software", "SOFTWARE", text_state)
    # Save updated document
    content_editor.save(outfile)