Come formattare il testo in Python

Aspose.Slides FOSS for Python fornisce una formattazione del testo a livello granulare tramite la classe PortionFormat. Un Portion è l’unità indipendente più piccola di testo; corrisponde a un singolo intervallo di formattazione all’interno di un paragrafo. Questa guida mostra come applicare la formattazione grassetto, corsivo, dimensione del carattere e colore al testo in una presentazione.

Guida passo-passo

Passo 1: Installa il pacchetto

pip install aspose-slides-foss

Passo 2: Aggiungi una forma con una casella di testo

Prima di formattare il testo, una forma deve contenere un TextFrame. Usa shape.add_text_frame() per crearne uno.

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)

Passo 3: Accedi al TextFrame

shape.add_text_frame() restituisce l’oggetto TextFrame. È possibile recuperarlo in seguito tramite shape.text_frame.

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

Un TextFrame contiene un elenco di oggetti Paragraph (tf.paragraphs).
Ogni Paragraph contiene oggetti Portion (paragraph.portions).

Passo 4: Applicare la formattazione grassetto e corsivo

Usa portion_format.font_bold e portion_format.font_italic. Queste proprietà accettano NullableBool.TRUE, NullableBool.FALSE o NullableBool.NOT_DEFINED (eredita dal 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)

Passo 5: Imposta la dimensione e il colore del carattere

Imposta portion_format.font_height per la dimensione (in punti) e usa fill_format per il colore.

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) accetta valori 0–255 per ciascun canale.

Passo 6: Più parti in un unico paragrafo

Un singolo paragrafo può contenere più parti con formattazioni diverse. Aggiungi un nuovo Portion alla collezione portions di un paragrafo:

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)

Problemi comuni e soluzioni

Il testo appare nero anche dopo aver impostato il colore

Assicurati che fill_format.fill_type = FillType.SOLID sia impostato prima di assegnare il colore. Se non imposti il tipo di riempimento, la modifica del colore potrebbe non avere effetto.

NullableBool.TRUE vs True

portion_format.font_bold si aspetta NullableBool.TRUE, non il Python True. Assegnare Python True può generare un TypeError o non fare nulla silenziosamente a seconda del binding.

Il font non appare nel file salvato

La proprietà latin_font imposta la famiglia di caratteri latini. Se non impostata, viene utilizzato il carattere del tema della presentazione. I caratteri personalizzati devono essere incorporati o disponibili sulla macchina di visualizzazione.

Domande Frequenti

Come cambio la famiglia di caratteri?

Imposta portion_format.latin_font:

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

FontData accetta il nome della famiglia di caratteri come stringa.

Come impostare l’allineamento del paragrafo?

Usa paragraph_format.alignment:

from aspose.slides_foss import TextAlignment

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

Valori supportati: LEFT, CENTER, RIGHT, JUSTIFY.

Come impostare l’interlinea?

Usa paragraph_format.space_before (punti prima del paragrafo) o paragraph_format.space_after (punti dopo il paragrafo):

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