Hur man formaterar text i Python

Aspose.Slides FOSS för Python erbjuder finmaskig textformatering via PortionFormat-klassen. En Portion är den minsta oberoende enheten av text; den motsvarar ett enda formateringssegment inom ett stycke. Denna guide visar hur man applicerar fetstil, kursiv, teckenstorlek och färgformatering på text i en presentation.

Steg-för-steg-guide

Steg 1: Installera paketet

pip install aspose-slides-foss

Steg 2: Lägg till en form med en textruta

Innan du formaterar text måste en form innehålla en TextFrame. Använd shape.add_text_frame() för att skapa en.

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)

Steg 3: Åtkomst till TextFrame

shape.add_text_frame() returnerar TextFrame-objektet. Du kan också hämta det senare via shape.text_frame.

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

En TextFrame innehåller en lista med Paragraph‑objekt (tf.paragraphs). Varje Paragraph innehåller Portion‑objekt (paragraph.portions).

Steg 4: Använd fet och kursiv formatering

Använd portion_format.font_bold och portion_format.font_italic. Dessa egenskaper accepterar NullableBool.TRUE, NullableBool.FALSE eller NullableBool.NOT_DEFINED (ärver från 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)

Steg 5: Ställ in teckenstorlek och färg

Ställ in portion_format.font_height för storlek (i punkter) och använd fill_format för färg.

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) accepterar värden 0–255 för varje kanal.

Steg 6: Flera delar i ett stycke

Ett stycke kan innehålla flera delar med olika formatering. Lägg till en ny Portion i styckets portions samling:

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)

Vanliga problem och lösningar

Text visas svart även efter att färgen har ställts in

Se till att fill_format.fill_type = FillType.SOLID är inställd innan färgen tilldelas. Utan att ange fyllningstypen kan färgändringen ha ingen effekt.

NullableBool.TRUE vs True

portion_format.font_bold förväntar sig NullableBool.TRUE, inte Python True. Att tilldela Python True kan orsaka ett TypeError eller tyst göra ingenting beroende på bindningen.

Typsnitt visas inte i den sparade filen

latin_font‑egenskapen anger den latinska teckensnittsfamiljen. Om den inte är angiven används presentationens temateckensnitt. Anpassade teckensnitt måste vara inbäddade eller tillgängliga på visningsdatorn.

Vanliga frågor

Hur ändrar jag teckensnittsfamiljen?

Ange portion_format.latin_font:

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

FontData accepterar teckensnittsfamiljens namn som en sträng.

Hur ställer jag in styckejustering?

Använd paragraph_format.alignment:

from aspose.slides_foss import TextAlignment

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

Stödda värden: LEFT, CENTER, RIGHT, JUSTIFY.

Hur ställer jag in radavstånd?

Använd paragraph_format.space_before (punkter före stycke) eller paragraph_format.space_after (punkter efter stycke):

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