Cara Memformat Teks di Python

Aspose.Slides FOSS for Python menyediakan pemformatan teks yang terperinci melalui kelas PortionFormat. Sebuah Portion adalah unit teks independen terkecil; ia memetakan ke satu run pemformatan dalam sebuah paragraf. Panduan ini menunjukkan cara menerapkan pemformatan tebal, miring, ukuran font, dan warna pada teks dalam sebuah presentasi.

Panduan Langkah-demi-Langkah

Langkah 1: Instal Paket

pip install aspose-slides-foss

Langkah 2: Tambahkan Bentuk dengan Bingkai Teks

Sebelum memformat teks, sebuah bentuk harus berisi TextFrame. Gunakan shape.add_text_frame() untuk membuatnya.

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)

Langkah 3: Akses TextFrame

shape.add_text_frame() mengembalikan objek TextFrame. Anda juga dapat mengambilnya nanti melalui shape.text_frame.

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

Sebuah TextFrame berisi daftar objek Paragraph (tf.paragraphs). Setiap Paragraph berisi objek Portion (paragraph.portions).

Langkah 4: Terapkan Pemformatan Tebal dan Miring

Gunakan portion_format.font_bold dan portion_format.font_italic. Properti‑properti ini menerima NullableBool.TRUE, NullableBool.FALSE, atau NullableBool.NOT_DEFINED (warisan dari 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)

Langkah 5: Atur Ukuran Font dan Warna

Set portion_format.font_height untuk ukuran (dalam poin) dan gunakan fill_format untuk warna.

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) menerima nilai 0–255 untuk setiap saluran.

Langkah 6: Beberapa Bagian dalam Satu Paragraf

Sebuah paragraf tunggal dapat berisi beberapa bagian dengan format yang berbeda. Tambahkan Portion baru ke koleksi portions paragraf:

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)

Masalah Umum dan Solusi

Teks muncul hitam meskipun sudah mengatur warna

Pastikan fill_format.fill_type = FillType.SOLID diatur sebelum menetapkan warna. Tanpa mengatur tipe isian, perubahan warna mungkin tidak berpengaruh.

NullableBool.TRUE vs True

portion_format.font_bold mengharapkan NullableBool.TRUE, bukan Python True. Menetapkan Python True dapat menyebabkan TypeError atau diam‑diam tidak melakukan apa‑apa tergantung pada binding.

Font tidak muncul di file yang disimpan

Properti latin_font mengatur keluarga font Latin. Jika tidak diatur, font tema presentasi akan digunakan. Font khusus harus disematkan atau tersedia pada mesin penampil.

Pertanyaan yang Sering Diajukan

Bagaimana cara mengubah keluarga font?

Atur portion_format.latin_font:

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

FontData menerima nama keluarga font sebagai string.

Bagaimana cara mengatur perataan paragraf?

Gunakan paragraph_format.alignment:

from aspose.slides_foss import TextAlignment

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

Nilai yang didukung: LEFT, CENTER, RIGHT, JUSTIFY.

Bagaimana cara mengatur spasi baris?

Gunakan paragraph_format.space_before (titik sebelum paragraf) atau paragraph_format.space_after (titik setelah paragraf):

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