Управление текстовыми полями в презентациях PowerPoint на Python через Java

О чём эта страница

Создавайте, просматривайте, изменяйте и удаляйте текстовые поля в презентациях PowerPoint с помощью Aspose.Slides для Python через Java. Сохраняйте форматирование и проверяйте сохранённые файлы PPTX и PPT.

Обзор

Текстовый абзац состоит из частей (portions). Обычная Portion содержит буквальный текст; часть‑поле также имеет Field, тип которого указывает автоматически обновляемое значение, например номер слайда или дату. Две части могут отображать одинаковые символы, но только одна из них содержит поле.

Используйте Portion.getField, чтобы различать их: для обычного текста он возвращает None. Portion.addField преобразует существующую часть в поле. Держите метку и её динамическое значение в отдельных частях, чтобы преобразование значения не заменило также метку.

Это руководство охватывает поля внутри текста, их форматирование и сохранение в PPTX и PPT. Для текстовых рамок и абзацев см. Manage Text.

Создание поля номера слайда

Следующий полностью работающий пример создает текстовое поле, содержащее буквальную метку Slide и автоматически обновляемый номер. Он задает размер, жирность и цвет числа перед добавлением поля, затем открывает сохранённую презентацию и проверяет тип поля, текст и форматирование. Входной файл не требуется.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, Portion, ShapeType, NullableBool, FillType, FieldType, SaveFormat
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 40, 40, 240, 50)
    shape.addTextFrame("Slide ")
    paragraph = shape.getTextFrame().getParagraphs().get_Item(0)

    number_portion = Portion()
    number_color = Color(0, 0, 139)
    number_portion.getPortionFormat().setFontHeight(24)
    number_portion.getPortionFormat().setFontBold(NullableBool.True_)
    number_portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid)
    number_portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(number_color)
    paragraph.getPortions().add(number_portion)
    number_portion.addField(FieldType.getSlideNumber())

    presentation.save("slide_number.pptx", SaveFormat.Pptx)

    reopened = Presentation("slide_number.pptx")
    try:
        saved_shape = reopened.getSlides().get_Item(0).getShapes().get_Item(0)
        saved_number = saved_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(1)
        saved_field = saved_number.getField()
        has_number_field = saved_field is not None and saved_field.getType().getInternalString() == FieldType.getSlideNumber().getInternalString()
        portion_format = saved_number.getPortionFormat()
        formatting_preserved = portion_format.getFontHeight() == 24 and portion_format.getFontBold() == NullableBool.True_
        formatting_preserved = formatting_preserved and portion_format.getFillFormat().getSolidFillColor().getColor().getRGB() == number_color.getRGB()

        print(f"Text: {saved_shape.getTextFrame().getText()}")
        print(f"Slide number field: {has_number_field}")
        print(f"Formatting preserved: {formatting_preserved}")
    finally:
        reopened.dispose()
finally:
    presentation.dispose()

Новая презентация начинается с номера слайда 1, поэтому текст будет Slide 1, и оба условия выводят True. Число остаётся полем после повторного открытия; это не буквальная 1. Индексы в проверке относятся к фигуре и частям, созданным в этом примере.

Выбор типа поля

FieldType предоставляет следующие методы для получения предопределённых значений. Передайте соответствующее значение в addField.

Метод	Назначение
getSlideNumber	Текущий номер слайда.
getDateTime	Дата/время в формате по умолчанию приложения‑рендерера.
getDateTime1–getDateTime9	Предопределённые форматы даты или комбинированные форматы даты/времени.
getDateTime10–getDateTime13	Предопределённые форматы времени, с опциями секунд и 12‑часового формата.
getHeader	Поле заголовка; см. ограничения placeholders и формата ниже.
getFooter	Поле нижнего колонтитула.

Например, getDateTime3 представляет день, полное название месяца и год на английском. Это предопределённые форматы полей, а не произвольные строки формата даты Python. Язык, установленный через setLanguageId, и приложение, обрабатывающее презентацию, могут влиять на отображаемый результат.

Создание поля из внутренней строки

Перегрузка строка метода addField принимает внутренний идентификатор поля. Используйте её, когда нужно сохранить идентификатор, предоставленный другим приложением, для которого нет предопределённого значения. Также можно создать FieldType из идентификатора. FieldType.getInternalString раскрывает этот идентификатор для проверки.

В этом примере сохраняется поле custom-report-id, специфичное для приложения, с резервным текстом Report-042. Идентификатор не регистрирует вычисление: Aspose.Slides не генерирует идентификаторы отчётов для неизвестных типов. Приложение, понимающее этот идентификатор, должно предоставить его смысл и обновлять значение.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, SaveFormat

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 40, 40, 300, 50)
    shape.addTextFrame("Report-042")
    portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
    portion.addField("custom-report-id")

    presentation.save("custom_field.pptx", SaveFormat.Pptx)

    reopened = Presentation("custom_field.pptx")
    try:
        saved_shape = reopened.getSlides().get_Item(0).getShapes().get_Item(0)
        saved_portion = saved_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
        saved_field = saved_portion.getField()
        type_name = "ordinary text" if saved_field is None else saved_field.getType().getInternalString()
        print(f"Type: {type_name}")
        print(f"Text: {saved_portion.getText()}")
    finally:
        reopened.dispose()
finally:
    presentation.dispose()

После прохождения данного PPTX‑циклица тип будет custom-report-id, а текст — Report-042. Передача строки вроде yyyy-MM-dd назовёт тип поля; она не настроит пользовательский формат даты. Для фиксированной даты в произвольном формате используйте обычный текст.

Просмотр, изменение и удаление полей даты/времени

Измените существующее поле через Field.setType. Убедитесь, что поле существует, прежде чем обращаться к его типу. Чтобы остановить автоматическое обновление, вызовите Portion.removeField. Это сохраняет часть и её текущий текст, удаляя связь с полем. Если нужен конкретный фиксированный значение, присвойте его после удаления поля.

Для настройки API, связанной с обработкой полей даты/времени, смотрите Presentation.setCurrentDateTime. Пример ниже использует явную дату утверждения при преобразовании поля в обычный текст.

Скачайте sample.pptx и поместите его в рабочий каталог. Файл содержит две именованные текстовые фигуры UpdatedAt и ApprovedDate, каждая с полем даты/времени, а также обычные текстовые метки. Приведённый пример проходит по верхнеуровневым текстовым фигурам обычных слайдов. Он меняет поля даты/времени на формат «длинная дата» и делает их курсивом, сохраняет остальное форматирование. Только поля в ApprovedDate превращаются в фиксированный текст.

Пример распознаёт встроенные внутренние идентификаторы datetime и datetime1…datetime13. Группы, таблицы, заметки, макеты и шаблоны требуют обхода собственных текстовых контейнеров и находятся за пределами данного примера.

import re
from datetime import date

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, AutoShape, FieldType, NullableBool, SaveFormat

presentation = Presentation("sample.pptx")
try:
    approval_date = date(2030, 4, 5)
    # Используйте английские названия месяцев независимо от локали системы.
    month_names = ("January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December")
    fixed_date = f"{approval_date.day:02d} {month_names[approval_date.month - 1]} {approval_date.year}"

    for slide in presentation.getSlides():
        for shape in slide.getShapes():
            if not isinstance(shape, AutoShape):
                continue
            if shape.getTextFrame() is None:
                continue

            for paragraph in shape.getTextFrame().getParagraphs():
                for portion in paragraph.getPortions():
                    field = portion.getField()
                    if field is None:
                        continue

                    type_name = field.getType().getInternalString()
                    is_date_time = type_name is not None and re.fullmatch(r"datetime([1-9]|1[0-3])?", str(type_name)) is not None
                    if not is_date_time:
                        continue

                    field.setType(FieldType.getDateTime3())
                    portion.getPortionFormat().setLanguageId("en-US")
                    portion.getPortionFormat().setFontItalic(NullableBool.True_)

                    if shape.getName() == "ApprovedDate":
                        portion.removeField()
                        portion.setText(fixed_date)

    presentation.save("updated_dates.pptx", SaveFormat.Pptx)

    reopened = Presentation("updated_dates.pptx")
    try:
        for shape in reopened.getSlides().get_Item(0).getShapes():
            if not isinstance(shape, AutoShape):
                continue
            if shape.getTextFrame() is None:
                continue
            if shape.getName() not in ("UpdatedAt", "ApprovedDate"):
                continue

            portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
            field = portion.getField()
            type_name = "ordinary text" if field is None else field.getType().getInternalString()
            print(f"{shape.getName()}: {type_name}; {portion.getText()}")
            print(f"Italic: {portion.getPortionFormat().getFontItalic()}")
    finally:
        reopened.dispose()
finally:
    presentation.dispose()

После повторного открытия UpdatedAt имеет тип datetime3 и остаётся динамическим. ApprovedDate не содержит поля и содержит 05 April 2030. Оба текстовых фрагмента даты – курсив, а их исходный размер шрифта, жирность и цвет остаются без изменений. Обычные метки текста остаются неизменными. Проверка читает первую часть двух известных фигур в предоставленном образце.

Сохранение форматирования текста

Работайте с существующей частью при добавлении поля, изменении его типа или удалении. Эти операции сохраняют форматирование части. Используйте Portion.getPortionFormat, чтобы менять только необходимые свойства, как показывают примеры для цвета или курсива.

Избегайте полной перестройки текстовой рамки только ради обновления одного поля: такой подход может потерять исходные границы частей и их индивидуальное форматирование. Также различайте явно установленное форматирование и наследуемое из абзаца, макета или темы. Смотрите Text Formatting для более широких возможностей форматирования.

Поля и placeholders заголовков/колонтитулов

Поле является частью текстовой части. Placeholder — это фигура с ролью в презентации, например нижний колонтитул или номер слайда. Добавление поля в обычный текстовый бокс не превращает эту фигуру в placeholder.

Менеджеры заголовков/колонтитулов управляют текстом placeholders и их видимостью на слайдах, макетах и шаблонах, включая распространение на зависимые слайды. Поэтому поле номера в пользовательском текстовом боксе может быть полезно даже при отсутствии использования placeholder для номера слайда. Напротив, изменение видимости placeholder не удаляет поле из несвязанного текстового бокса.

Предопределённые типы заголовков и колонтитулов не создают соответствующие placeholders и не заполняют их содержимым. В частности, обычный слайд PowerPoint не имеет placeholder‑заголовка; заголовки относятся к страницам заметок и раздаточным материалам. Не следует полагать, что поле заголовка или нижнего колонтитула в произвольной фигуре автоматически получит текст, настроенный через менеджер placeholders. Для такого сценария см. Presentation Headers and Footers.

Ограничения PPTX и PPT

Проверяйте как тип поля, так и полученный текст после сохранения и повторного открытия. Сохранение идентификатора не доказывает, что приложение способно вычислить или отобразить его значение.

Формат Поведение поля и ограничения

PPTX Хранит внутренние идентификаторы полей вместе с их текстом. При проверках в цикле сохранения/открытия предопределённые типы и пользовательский идентификатор из примера сохраняются. Неизвестный пользовательский тип сохраняет свой резервный текст; он не получает логики автоматических вычислений. Другое приложение может по‑разному обрабатывать неподдерживаемые идентификаторы.

PPT Использует устаревшие представления полей и имеет более ограниченную совместимость. При проверках в цикле номер слайда и предопределённые поля даты/времени сохраняются. Пользовательское поле в обычном текстовом боксе открывается с его идентификатором, но текстом *; поле заголовка в том же контексте тоже даёт *. Не полагайтесь на сохранение видимого текста пользовательских или неподдерживаемых полей.

Для переносимого фиксированного вывода преобразуйте неподдерживаемые поля в обычный текст и явно задайте желаемое значение перед сохранением. Это сохраняет выбранный текст, но намеренно отключает автоматические обновления. Тестируйте целевое приложение, если его собственный пересчёт полей входит в ваш рабочий процесс.

FAQ

Как определить, является ли отображаемый номер или дата полем?

Проверьте Portion.getField. Значение, отличное от None, указывает на поле; по самому отображаемому тексту определить нельзя.

Удаляет ли удаление поля его текст или форматирование?

Нет. removeField преобразует существующую часть в обычный текст. При необходимости присвойте явное значение после удаления, если нужен определённый фиксированный текст или резервное значение.

Может ли внутренняя строка определить новый формат даты или формулу?

Нет. Она лишь идентифицирует тип поля. Неизвестный идентификатор не предоставляет вычислителя или шаблона формата даты Python. Используйте поддерживаемый предопределённый тип или форматируйте значение сами как обычный текст.

Почему после сохранения презентацию нужно проверять ещё раз?

Идентификаторы полей, вычисленный текст и форматирование — это отдельные аспекты, которые следует проверять. Конверсия формата может изменить видимый результат, даже если идентификатор поля остаётся.

Форматирование текста презентации в Python через Java Поиск и замена текста в презентациях PowerPoint на Python через Java