Como formatar texto em Python

Aspose.Slides FOSS for Python fornece formatação de texto de granularidade fina por meio da classe PortionFormat. Um Portion é a menor unidade independente de texto; ele corresponde a uma única execução de formatação dentro de um parágrafo. Este guia mostra como aplicar formatação em negrito, itálico, tamanho de fonte e cor ao texto em uma apresentação.

Guia passo a passo

Etapa 1: Instalar o Pacote

pip install aspose-slides-foss

Etapa 2: Adicionar uma Forma com uma Caixa de Texto

Antes de formatar o texto, uma forma deve conter um TextFrame. Use shape.add_text_frame() para criar um.

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: Acessar o TextFrame

shape.add_text_frame() retorna o objeto TextFrame. Você também pode recuperá‑lo mais tarde via shape.text_frame.

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

Um TextFrame contém uma lista de objetos Paragraph (tf.paragraphs). Cada Paragraph contém objetos Portion (paragraph.portions).

Etapa 4: Aplicar Formatação em Negrito e Itálico

Use portion_format.font_bold e portion_format.font_italic. Essas propriedades aceitam NullableBool.TRUE, NullableBool.FALSE ou NullableBool.NOT_DEFINED (herda do mestre).

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)

Etapa 5: Definir tamanho e cor da fonte

Defina portion_format.font_height para tamanho (em pontos) e use fill_format para cor.

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) aceita valores 0–255 para cada canal.

Etapa 6: Múltiplas Porções em Um Parágrafo

Um único parágrafo pode conter várias partes com formatação diferente. Adicione um novo Portion à coleção portions de um parágrafo:

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)

Problemas Comuns e Soluções

O texto aparece preto mesmo após definir a cor

Certifique‑se de que fill_format.fill_type = FillType.SOLID esteja definido antes de atribuir a cor. Sem definir o tipo de preenchimento, a alteração de cor pode não ter efeito.

NullableBool.TRUE vs True

portion_format.font_bold espera NullableBool.TRUE, não o Python True. Atribuir o Python True pode gerar um TypeError ou ficar silenciosamente sem fazer nada, dependendo da ligação.

Fonte não aparece no arquivo salvo

A propriedade latin_font define a família de fontes Latin. Se não for definida, a fonte do tema da apresentação será usada. Fontes personalizadas devem estar incorporadas ou disponíveis na máquina de visualização.

Perguntas Frequentes

Como altero a família de fontes?

Definir portion_format.latin_font:

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

FontData aceita o nome da família de fontes como uma string.

Como defino o alinhamento de parágrafo?

Use paragraph_format.alignment:

from aspose.slides_foss import TextAlignment

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

Valores suportados: LEFT, CENTER, RIGHT, JUSTIFY.

Como definir o espaçamento entre linhas?

Use paragraph_format.space_before (pontos antes do parágrafo) ou paragraph_format.space_after (pontos depois do parágrafo):

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