Documentation – 文本操作

Python-Net: 在页面上替换文本

Mon, 08 Jun 2026 00:00:00 +0000

在更新 PDF 文档时，文本替换是一个常见需求。使用 PdfContentEditor, 您可以搜索特定文本并将其替换为新内容。‘replace_text_strategy’ 属性允许您控制要替换的出现次数。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
配置文本替换策略。
替换目标文本。
保存更新后的 PDF 文档。

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: 在页面上使用状态替换文本

Mon, 08 Jun 2026 00:00:00 +0000

有时在 PDF 中替换文本还需要进行格式更改，如颜色或字体大小。使用 TextState，您可以定义样式属性并在替换时应用它们。这使您能够突出显示已修改的文本或在文档间强制一致的格式。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
定义具有自定义格式的 TextState。
配置替换策略。
在特定页面上替换文本。
保存更新后的 PDF 文档。

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: 替换文本正则

Mon, 08 Jun 2026 00:00:00 +0000

正则表达式允许基于模式而非固定字符串进行灵活的文本替换。通过在 ‘replace_text_strategy’ 中启用正则支持，您可以匹配诸如数字、日期或格式化字符串等动态内容。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
配置替换策略以使用正则表达式。
在整个文档中替换匹配的模式。
保存更新后的 PDF 文档。

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: 简单替换文本

Mon, 08 Jun 2026 00:00:00 +0000

在文档中更新重复值时，简单的文本替换非常有用。使用 PdfContentEditor, 您可以定义替换范围，并在所有页面上全局替换文本。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
为所有出现配置替换范围。
替换目标文本。
保存更新后的 PDF 文档。

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: 使用状态替换文本

Mon, 08 Jun 2026 00:00:00 +0000

在 PDF 中更新文本时，您可能希望替换的内容突出显示。通过使用 TextState 对象，您可以定义颜色、字体大小等样式，然后将其应用于所有被替换的文本。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
定义具有自定义格式的 TextState。
配置替换范围。
替换整个文档中的文本。
保存更新后的 PDF 文档。

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)