Aspose.Slides FOSS
Python
Как форматировать текст в Python

Как форматировать текст в Python

Aspose.Slides FOSS for Python предоставляет детальное форматирование текста через класс PortionFormat. Portion — это наименьшая независимая единица текста; она соответствует одному запуску форматирования внутри абзаца. В этом руководстве показано, как применить полужирное, курсивное, размер шрифта и цветовое форматирование к тексту в презентации.

Пошаговое руководство

Шаг 1: Установить пакет 

pip install aspose-slides-foss

Шаг 2: Добавить форму с текстовым фреймом

Перед форматированием текста форма должна содержать TextFrame. Используйте shape.add_text_frame(), чтобы создать её.

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 500, 150)
    tf = shape.add_text_frame("Default text: will be formatted")
    prs.save("output.pptx", SaveFormat.PPTX)

Шаг 3: Доступ к TextFrame

shape.add_text_frame() возвращает объект TextFrame. Вы также можете получить его позже через shape.text_frame.

tf = shape.text_frame          # if the frame already exists
tf = shape.add_text_frame("") # creates a new frame

TextFrame содержит список объектов Paragraph (tf.paragraphs). Каждый Paragraph содержит Portion объектов (paragraph.portions).

Шаг 4: Применить полужирное и курсивное форматирование

Используйте portion_format.font_bold и portion_format.font_italic. Эти свойства принимают NullableBool.TRUE, NullableBool.FALSE или NullableBool.NOT_DEFINED (наследуются от мастера).

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, NullableBool
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 500, 150)
    tf = shape.add_text_frame("Bold and italic text")

    fmt = tf.paragraphs[0].portions[0].portion_format
    fmt.font_bold = NullableBool.TRUE
    fmt.font_italic = NullableBool.TRUE

    prs.save("bold-italic.pptx", SaveFormat.PPTX)

Шаг 5: Установить размер шрифта и цвет

Установите portion_format.font_height для размера (в пунктах) и используйте fill_format для цвета.

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, NullableBool, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 500, 150)
    tf = shape.add_text_frame("Large corporate-blue heading")

    fmt = tf.paragraphs[0].portions[0].portion_format
    fmt.font_height = 32                          # 32pt font
    fmt.font_bold = NullableBool.TRUE
    fmt.fill_format.fill_type = FillType.SOLID
    fmt.fill_format.solid_fill_color.color = Color.from_argb(255, 0, 70, 127)

    prs.save("colored-text.pptx", SaveFormat.PPTX)

Color.from_argb(alpha, red, green, blue) принимает значения 0–255 для каждого канала.

Шаг 6: Несколько частей в одном абзаце

Один абзац может содержать несколько частей с разным форматированием. Добавьте новый Portion в коллекцию portions абзаца:

import aspose.slides_foss as slides
from aspose.slides_foss import ShapeType, NullableBool, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 600, 100)
    tf = shape.add_text_frame("")  # start with empty frame

    paragraph = tf.paragraphs[0]

    # First portion: normal text
    portion1 = paragraph.portions[0]
    portion1.text = "Normal text followed by "
    portion1.portion_format.font_height = 20

    # Second portion: bold red text
    portion2 = slides.Portion()
    portion2.text = "bold red text"
    portion2.portion_format.font_height = 20
    portion2.portion_format.font_bold = NullableBool.TRUE
    portion2.portion_format.fill_format.fill_type = FillType.SOLID
    portion2.portion_format.fill_format.solid_fill_color.color = Color.from_argb(255, 200, 0, 0)
    paragraph.portions.add(portion2)

    prs.save("mixed-format.pptx", SaveFormat.PPTX)

Общие проблемы и исправления

Текст отображается черным, даже после установки цвета

Убедитесь, что fill_format.fill_type = FillType.SOLID установлен перед назначением цвета. Без установки типа заливки изменение цвета может не дать эффекта.

NullableBool.TRUE против True

portion_format.font_bold ожидает NullableBool.TRUE, а не Python True. Присваивание Python True может вызвать TypeError или молча ничего не сделать в зависимости от привязки.

Шрифт не отображается в сохранённом файле

Свойство latin_font задает семейство шрифтов Latin. Если не задано, используется шрифт темы презентации. Пользовательские шрифты должны быть встроены или доступны на машине просмотра.

Часто задаваемые вопросы

Как изменить семейство шрифтов?

Установить portion_format.latin_font:

fmt.latin_font = slides.FontData("Arial")

FontData принимает имя семейства шрифтов в виде строки.

Как установить выравнивание абзаца?

Используйте paragraph_format.alignment:

from aspose.slides_foss import TextAlignment

tf.paragraphs[0].paragraph_format.alignment = TextAlignment.CENTER

Поддерживаемые значения: LEFT, CENTER, RIGHT, JUSTIFY.

Как установить межстрочный интервал?

Используйте paragraph_format.space_before (точки перед абзацем) или paragraph_format.space_after (точки после абзаца):

tf.paragraphs[0].paragraph_format.space_before = 12   # 12pt before
tf.paragraphs[0].paragraph_format.space_after = 6     # 6pt after

См. также

 Русский