Hoe Tekst Opmaken in Python

Aspose.Slides FOSS for Python biedt fijnmazige tekstopmaak via de PortionFormat-klasse. Een Portion is de kleinste onafhankelijke eenheid van tekst; het komt overeen met een enkele opmaakrun binnen een alinea. Deze gids laat zien hoe u vet, cursief, lettergrootte en kleuropmaak op tekst in een presentatie toepast.

Stapsgewijze handleiding

Stap 1: Installeer het pakket

pip install aspose-slides-foss

Stap 2: Voeg een vorm toe met een tekstvak

Voordat u tekst opmaakt, moet een vorm een TextFrame bevatten. Gebruik shape.add_text_frame() om er een 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 de TextFrame

shape.add_text_frame() retourneert het TextFrame object. 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). Elke Paragraph bevat Portion objecten (paragraph.portions).

Stap 4: Vet‑ en cursiefopmaak toepassen

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

Stel portion_format.font_height in 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 delen in één alinea

Een enkele alinea kan meerdere delen bevatten met verschillende opmaak. Voeg een nieuwe Portion toe aan de portions-collectie van een alinea:

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 verschijnt zwart, zelfs na het instellen van 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. Het toewijzen van Python True kan een TypeError veroorzaken of stilzwijgend niets doen, afhankelijk van de binding.

Lettertype verschijnt niet in het opgeslagen bestand

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

Veelgestelde vragen

Hoe wijzig 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 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