Як форматувати текст у 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 встановлює сімейство латинських шрифтів. Якщо не встановлено, використовується шрифт теми презентації. Користувацькі шрифти повинні бути вбудовані або доступні на машині перегляду.

Поширені запитання

Як змінити сімейство шрифтів?

Встановити 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