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

Як форматувати текст у Python

Aspose.Slides FOSS for Python provides fine-grained text formatting through the PortionFormat клас. A 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

A TextFrame містить список Paragraph об’єктів (tf.paragraphs). Paragraph містить Portion об’єктів (paragraph.portions).

Крок 4: Застосуйте жирний та курсивний формат

Використовуйте portion_format.font_bold і portion_format.font_italic. Ці властивості приймають NullableBool.TRUE, NullableBool.FALSE, або NullableBool.NOT_DEFINED (успадковується від master).

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 в одному абзаці

Один абзац може містити кілька частин з різним форматуванням. Додайте новий 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 або безшумно нічого не робити залежно від прив’язки.

Шрифт не відображається у збереженому файлі

The 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

Див. також

 Українська