Hur man formaterar text i Python

Aspose.Slides FOSS for Python provides fine-grained text formatting through the PortionFormat klass. A Portion är den minsta oberoende enheten av text; den motsvarar ett enda formateringssteg inom ett stycke. Denna guide visar hur man applicerar fetstil, kursiv, teckenstorlek och färgformattering 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 textram

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: Få å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: Applicera fetstil 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 (ärva 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

Ange 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 Portioner i ett stycke

Ett enda stycke kan innehålla flera delar med olika formatering. Lägg till en ny Portion till ett styckes 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

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

Säkerställ 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. Tilldelning av Python True kan orsaka en TypeError eller tyst göra ingenting beroende på bindningen.

Typsnitt visas inte i den sparade filen

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

Vanliga frågor

Hur ändrar jag teckensnittsfamiljen?

Ställ in 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 stycket) eller paragraph_format.space_after (punkter efter stycket):

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