Cum să formatați textul în Python

Aspose.Slides FOSS for Python provides fine-grained text formatting through the PortionFormat clasă. A Portion este cea mai mică unitate independentă de text; se potrivește cu o singură rulă de formatare într-un paragraf. Acest ghid arată cum să aplici formatarea îngroșată, cursivă, dimensiunea fontului și culoarea textului într-o prezentare.

Ghid pas cu pas

Pasul 1: Instalați pachetul

pip install aspose-slides-foss

Pasul 2: Adaugă o formă cu un cadru de text

Înainte de a formata textul, o formă trebuie să conțină un TextFrame. Use shape.add_text_frame() pentru a crea una.

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)

Pasul 3: Accesează TextFrame-ul

shape.add_text_frame() returnează TextFrame obiect. Poți, de asemenea, să îl recuperezi mai târziu prin shape.text_frame.

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

Un TextFrame conține o listă de Paragraph obiecte (tf.paragraphs). Fiecare Paragraph conține Portion obiecte (paragraph.portions).

Pasul 4: Aplică formatarea îngroșată și cursivă

Utilizaţi portion_format.font_bold și portion_format.font_italic. Aceste proprietăţi acceptă NullableBool.TRUE, NullableBool.FALSE, sau NullableBool.NOT_DEFINED (moștenește de la 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)

Pasul 5: Setează dimensiunea și culoarea fontului

Setaţi portion_format.font_height pentru dimensiune (în puncte) și folosiţi fill_format pentru culoare.

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) acceptă valori 0–255 pentru fiecare canal.

Pasul 6: Mai multe porțiuni într-un singur paragraf

Un singur paragraf poate conține mai multe porțiuni cu formatare diferită. Adaugă un nou Portion la colecția unui paragraf portions colecție:

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)

Probleme comune și soluții

Textul apare negru chiar și după setarea culorii

Asigură fill_format.fill_type = FillType.SOLID este setat înainte de a atribui culoarea. Fără setarea tipului de umplere, schimbarea culorii poate să nu aibă efect.

NullableBool.TRUE vs True

portion_format.font_bold se așteaptă NullableBool.TRUE, nu Python True. Atribuirea Python True poate genera un TypeError sau să nu facă nimic în tăcere, în funcție de legătură.

Fontul nu apare în fișierul salvat

The latin_font proprietatea stabilește familia de fonturi Latin. Dacă nu este setată, se folosește fontul temei de prezentare. Fonturile personalizate trebuie să fie încorporate sau disponibile pe mașina de vizualizare.

Întrebări frecvente

Cum pot schimba familia de fonturi?

Setați portion_format.latin_font:

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

FontData acceptă numele familiei de fonturi ca șir.

Cum pot seta alinierea paragrafului?

Utilizați paragraph_format.alignment:

from aspose.slides_foss import TextAlignment

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

Valori acceptate: LEFT, CENTER, RIGHT, JUSTIFY.

Cum pot seta spațierea între linii?

Utilizați paragraph_format.space_before (puncte înainte de paragraf) sau paragraph_format.space_after (puncte după paragraf):

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