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 (inherit от 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 към колекцията 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

Вижте също

 Български