Documentation – Операции с текстом

Python-Net: Заменить текст на странице

Fri, 20 Mar 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: Заменить текст на странице с помощью state

Fri, 20 Mar 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: Замена текста с использованием RegEx

Fri, 20 Mar 2026 00:00:00 +0000

Регулярные выражения позволяют гибко заменять текст на основе шаблонов, а не фиксированных строк. Включив поддержку regex в ‘replace_text_strategy’, вы можете сопоставлять динамичное содержимое, такое как числа, даты или отформатированные строки.

Создайте PdfContentEditor экземпляр.
Привяжите входной PDF‑документ.
Настройте стратегию замены для использования regex.
Заменить совпадающие шаблоны во всем документе.
Сохраните обновлённый 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: Простая замена текста

Fri, 20 Mar 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: Заменить текст с использованием state

Fri, 20 Mar 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)