Hoe tekst opmaken in Python

Aspose.Slides FOSS for Python provides fine-grained text formatting through the PortionFormat klasse. A Portion is de kleinste onafhankelijke eenheid van tekst; het komt overeen met één opmaakrun binnen een alinea. Deze gids laat zien hoe je vet, cursief, lettergrootte en kleuropmaak op tekst in een presentatie kunt toepassen.

Stapsgewijze handleiding

Stap 1: Installeer het pakket

pip install aspose-slides-foss

Stap 2: Voeg een vorm toe met een tekstframe

Voordat je tekst opmaakt, moet een vorm een TextFrame. Gebruik shape.add_text_frame() om er één te maken.

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)

Stap 3: Toegang tot het TextFrame

shape.add_text_frame() geeft de TextFrame object terug. Je kunt het later ook ophalen via shape.text_frame.

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

Een TextFrame bevat een lijst met Paragraph objecten (tf.paragraphs). Elk Paragraph bevat Portion objecten (paragraph.portions).

Stap 4: Pas vet‑ en cursiefopmaak toe

Gebruik portion_format.font_bold en portion_format.font_italic. Deze eigenschappen accepteren NullableBool.TRUE, NullableBool.FALSE, of NullableBool.NOT_DEFINED (erven van 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)

Stap 5: Stel lettergrootte en kleur in

Instellen portion_format.font_height voor grootte (in punten) en gebruik fill_format voor kleur.

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) accepteert waarden 0–255 voor elk kanaal.

Stap 6: Meerdere portions in één alinea

Een enkele alinea kan meerdere delen met verschillende opmaak bevatten. Voeg een nieuwe Portion aan een alinea’s portions collectie:

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)

Veelvoorkomende problemen en oplossingen

Tekst blijft zwart, zelfs na het instellen van de kleur

Zorg ervoor dat fill_format.fill_type = FillType.SOLID is ingesteld voordat de kleur wordt toegewezen. Zonder het instellen van het vultype heeft de kleurverandering mogelijk geen effect.

NullableBool.TRUE vs True

portion_format.font_bold verwacht NullableBool.TRUE, niet de Python True. Toewijzen van Python True kan een TypeError of stilzwijgend niets doen, afhankelijk van de binding.

Lettertype verschijnt niet in het opgeslagen bestand

De latin_font eigenschap stelt de Latijnse lettertypefamilie in. Als deze niet is ingesteld, wordt het lettertype van het presentatiethema gebruikt. Aangepaste lettertypen moeten ingebed zijn of beschikbaar op de weergavemachine.

Veelgestelde vragen

Hoe verander ik de lettertypefamilie?

Instellen portion_format.latin_font:

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

FontData accepteert de naam van de lettertypefamilie als een string.

Hoe stel ik de alinea‑uitlijning in?

Gebruik paragraph_format.alignment:

from aspose.slides_foss import TextAlignment

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

Ondersteunde waarden: LEFT, CENTER, RIGHT, JUSTIFY.

Hoe stel ik de regelafstand in?

Gebruik paragraph_format.space_before (punten vóór alinea) of paragraph_format.space_after (punten na alinea):

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