Jak formatować tekst w Pythonie

Aspose.Slides FOSS for Python zapewnia precyzyjne formatowanie tekstu za pomocą klasy PortionFormat. Portion jest najmniejszą niezależną jednostką tekstu; odpowiada pojedynczemu fragmentowi formatowania w akapicie. Ten przewodnik pokazuje, jak zastosować pogrubienie, kursywę, rozmiar czcionki i formatowanie koloru do tekstu w prezentacji.

Przewodnik krok po kroku

Krok 1: Zainstaluj pakiet

pip install aspose-slides-foss

Krok 2: Dodaj kształt z ramką tekstową

Przed formatowaniem tekstu kształt musi zawierać TextFrame. Użyj shape.add_text_frame(), aby go utworzyć.

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)

Krok 3: Uzyskaj dostęp do TextFrame

shape.add_text_frame() zwraca obiekt TextFrame. Możesz go również pobrać później za pomocą shape.text_frame.

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

TextFrame zawiera listę obiektów Paragraph (tf.paragraphs). Każdy Paragraph zawiera obiekty Portion (paragraph.portions).

Krok 4: Zastosuj pogrubienie i kursywę

Użyj portion_format.font_bold i portion_format.font_italic. Te właściwości akceptują NullableBool.TRUE, NullableBool.FALSE lub NullableBool.NOT_DEFINED (dziedziczone z 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)

Krok 5: Ustaw rozmiar i kolor czcionki

Ustaw portion_format.font_height dla rozmiaru (w punktach) i użyj fill_format dla koloru.

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) akceptuje wartości 0–255 dla każdego kanału.

Krok 6: Wiele części w jednym akapicie

Pojedynczy akapit może zawierać wiele fragmentów o różnym formatowaniu. Dodaj nowy Portion do kolekcji portions akapitu:

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)

Typowe problemy i rozwiązania

Tekst wyświetla się czarny mimo ustawienia koloru

Upewnij się, że fill_format.fill_type = FillType.SOLID jest ustawiony przed przypisaniem koloru. Bez ustawienia typu wypełnienia zmiana koloru może nie przynieść efektu.

NullableBool.TRUE vs True

portion_format.font_bold oczekuje NullableBool.TRUE, a nie Python True. Przypisanie Python True może spowodować TypeError lub cicho nic nie zrobić, w zależności od powiązania.

Czcionka nie pojawia się w zapisanym pliku

Właściwość latin_font ustawia rodzinę czcionek łacińskich. Jeśli nie zostanie ustawiona, używana jest czcionka motywu prezentacji. Czcionki niestandardowe muszą być osadzone lub dostępne na maszynie wyświetlającej.

Najczęściej zadawane pytania

Jak zmienić rodzinę czcionek?

Ustaw portion_format.latin_font:

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

FontData akceptuje nazwę rodziny czcionki jako ciąg znaków.

Jak ustawić wyrównanie akapitu?

Użyj paragraph_format.alignment:

from aspose.slides_foss import TextAlignment

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

Obsługiwane wartości: LEFT, CENTER, RIGHT, JUSTIFY.

Jak ustawić odstęp między wierszami?

Użyj paragraph_format.space_before (punkty przed akapitem) lub paragraph_format.space_after (punkty po akapicie):

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