Cum să formatezi text în Python

Aspose.Slides FOSS for Python oferă formatare de text cu granulație fină prin clasa PortionFormat. Un Portion este cea mai mică unitate independentă de text; se mapă la o singură rulă de formatare într-un paragraf. Acest ghid arată cum să aplicați 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: Adăugați o formă cu un cadru de text

Înainte de a formata textul, o formă trebuie să conțină un TextFrame. Folosește 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: Accesați TextFrame

shape.add_text_frame() returnează obiectul TextFrame. De asemenea, îl puteţi recupera 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 obiecte Paragraph (tf.paragraphs). Fiecare Paragraph conține obiecte Portion (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ștenite 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

Setează portion_format.font_height pentru dimensiune (în puncte) și folosește 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 paragraf

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

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

Asigurați-vă că 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 așteaptă NullableBool.TRUE, nu Python True. Atribuirea Python True poate genera o TypeError sau poate să nu facă nimic în mod silențios, în funcție de legătură.

Fontul nu apare în fișierul salvat

Proprietatea latin_font setează 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 un șir.

Cum să setez 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 să setez 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