Kelola Paragraf Teks PowerPoint di Python

Pendahuluan

Aspose.Slides menyediakan kelas-kelas yang Anda perlukan untuk bekerja dengan teks PowerPoint di Python.

  • Aspose.Slides menyediakan kelas TextFrame untuk membuat objek bingkai teks. Sebuah objek TextFrame dapat berisi satu atau beberapa paragraf (setiap paragraf dipisahkan oleh penanda baris baru).
  • Aspose.Slides menyediakan kelas Paragraph untuk membuat objek paragraf. Sebuah objek Paragraph dapat berisi satu atau beberapa bagian teks.
  • Aspose.Slides menyediakan kelas Portion untuk membuat objek bagian teks dan menentukan properti pemformatannya.

Objek Paragraph dapat menangani teks dengan properti pemformatan yang berbeda melalui objek Portion yang mendasarinya.

Menambahkan Beberapa Paragraf yang Mengandung Beberapa Bagian

Langkah‑langkah berikut menunjukkan cara menambahkan sebuah bingkai teks yang berisi tiga paragraf, masing‑masing dengan tiga bagian:

  1. Buat sebuah instance dari kelas Presentation.
  2. Dapatkan referensi ke slide target berdasarkan indeksnya.
  3. Tambahkan sebuah AutoShape berbentuk persegi panjang ke slide.
  4. Dapatkan TextFrame yang terkait dengan AutoShape.
  5. Buat dua objek Paragraph dan tambahkan ke koleksi paragraf TextFrame (bersama dengan paragraf default, ini menghasilkan tiga paragraf).
  6. Untuk setiap paragraf, buat tiga objek Portion dan tambahkan ke koleksi bagian paragraf tersebut.
  7. Tetapkan teks untuk setiap bagian.
  8. Terapkan pemformatan yang diinginkan ke setiap bagian teks menggunakan properti yang disediakan oleh Portion.
  9. Simpan presentasi yang telah dimodifikasi.

Kode Python berikut mengimplementasikan langkah‑langkah tersebut:

import aspose.slides as slides
import aspose.pydrawing as draw

# Instansiasi kelas Presentation untuk membuat file PPTX baru.
with slides.Presentation() as presentation:

    # Akses slide pertama.
    slide = presentation.slides[0]

    # Tambahkan AutoShape berbentuk persegi panjang.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 150, 300, 150)

    # Akses TextFrame milik AutoShape.
    text_frame = shape.text_frame

    # Buat paragraf dan bagian; pemformatan diterapkan di bawah.
    paragraph0 = text_frame.paragraphs[0]
    portion01 = slides.Portion()
    portion02 = slides.Portion()
    paragraph0.portions.add(portion01)
    paragraph0.portions.add(portion02)

    paragraph1 = slides.Paragraph()
    text_frame.paragraphs.add(paragraph1)
    portion10 = slides.Portion()
    portion11 = slides.Portion()
    portion12 = slides.Portion()
    paragraph1.portions.add(portion10)
    paragraph1.portions.add(portion11)
    paragraph1.portions.add(portion12)

    paragraph2 = slides.Paragraph()
    text_frame.paragraphs.add(paragraph2)
    portion20 = slides.Portion()
    portion21 = slides.Portion()
    portion22 = slides.Portion()
    paragraph2.portions.add(portion20)
    paragraph2.portions.add(portion21)
    paragraph2.portions.add(portion22)

    for i in range(3):
        for j in range(3):
            text_frame.paragraphs[i].portions[j].text = "Portion0" + str(j)
            if j == 0:
                text_frame.paragraphs[i].portions[j].portion_format.fill_format.fill_type = slides.FillType.SOLID
                text_frame.paragraphs[i].portions[j].portion_format.fill_format.solid_fill_color.color = draw.Color.red
                text_frame.paragraphs[i].portions[j].portion_format.font_bold = 1
                text_frame.paragraphs[i].portions[j].portion_format.font_height = 15
            elif j == 1:
                text_frame.paragraphs[i].portions[j].portion_format.fill_format.fill_type = slides.FillType.SOLID
                text_frame.paragraphs[i].portions[j].portion_format.fill_format.solid_fill_color.color = draw.Color.blue
                text_frame.paragraphs[i].portions[j].portion_format.font_italic = 1
                text_frame.paragraphs[i].portions[j].portion_format.font_height = 18

    # Simpan PPTX ke disk.
    presentation.save("paragraphs_and_portions_out.pptx", slides.export.SaveFormat.PPTX)

Mengelola Bullet Paragraf

Daftar bullet membantu Anda mengatur dan menyajikan informasi dengan cepat dan efisien. Paragraf ber‑bullet biasanya lebih mudah dibaca dan dipahami.

  1. Buat sebuah instance dari kelas Presentation.
  2. Akses slide target berdasarkan indeksnya.
  3. Tambahkan sebuah AutoShape ke slide.
  4. Akses TextFrame pada shape tersebut.
  5. Hapus paragraf default dari TextFrame.
  6. Buat paragraf pertama menggunakan kelas Paragraph.
  7. Atur tipe bullet paragraf menjadi SYMBOL dan tentukan karakter bullet.
  8. Tetapkan teks paragraf.
  9. Atur indent bullet untuk paragraf.
  10. Atur warna bullet.
  11. Atur ukuran bullet (tinggi).
  12. Tambahkan paragraf ke koleksi paragraf TextFrame.
  13. Tambahkan paragraf kedua dan ulangi langkah 7–12.
  14. Simpan presentasi.

Kode Python berikut menunjukkan cara menambahkan paragraf ber‑bullet:

import aspose.slides as slides
import aspose.pydrawing as draw

# Buat instansi presentasi.
with slides.Presentation() as presentation:

    # Akses slide pertama.
    slide = presentation.slides[0]

    # Tambah dan akses AutoShape.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # Akses teks frame dari AutoShape yang dibuat.
    text_frame = shape.text_frame

    # Hapus paragraf default.
    text_frame.paragraphs.remove_at(0)

    # Buat paragraf.
    paragraph = slides.Paragraph()

    # Atur gaya bullet paragraf dan simbol.
    paragraph.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph.paragraph_format.bullet.char = chr(8226)

    # Atur teks paragraf.
    paragraph.text = "Welcome to Aspose.Slides"

    # Atur indent bullet.
    paragraph.paragraph_format.indent = 25

    # Atur warna bullet.
    paragraph.paragraph_format.bullet.color.color_type = slides.ColorType.RGB
    paragraph.paragraph_format.bullet.color.color = draw.Color.black
    paragraph.paragraph_format.bullet.is_bullet_hard_color = 1 

    # Atur tinggi bullet.
    paragraph.paragraph_format.bullet.height = 100

    # Tambahkan paragraf ke teks frame.
    text_frame.paragraphs.add(paragraph)

    # Buat paragraf kedua.
    paragraph2 = slides.Paragraph()

    # Atur jenis dan gaya bullet paragraf.
    paragraph2.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    paragraph2.paragraph_format.bullet.numbered_bullet_style = slides.NumberedBulletStyle.BULLET_CIRCLE_NUM_WDBLACK_PLAIN

    # Atur teks paragraf.
    paragraph2.text = "This is numbered bullet"

    # Atur indent bullet.
    paragraph2.paragraph_format.indent = 25

    # Atur warna bullet.
    paragraph2.paragraph_format.bullet.color.color_type = slides.ColorType.RGB
    paragraph2.paragraph_format.bullet.color.color = draw.Color.black
    paragraph2.paragraph_format.bullet.is_bullet_hard_color = 1

    # Atur tinggi bullet.
    paragraph2.paragraph_format.bullet.height = 100

    # Tambahkan paragraf ke teks frame.
    text_frame.paragraphs.add(paragraph2)

    # Simpan presentasi sebagai file PPTX.
    presentation.save("bullets_out.pptx", slides.export.SaveFormat.PPTX)

Mengelola Bullet Gambar

Daftar bullet membantu Anda mengatur dan menyajikan informasi dengan cepat dan efisien. Bullet gambar mudah dibaca dan dipahami.

  1. Buat sebuah instance dari kelas Presentation.
  2. Akses slide target berdasarkan indeksnya.
  3. Tambahkan sebuah AutoShape ke slide.
  4. Akses TextFrame pada shape tersebut.
  5. Hapus paragraf default dari TextFrame.
  6. Buat paragraf pertama menggunakan kelas Paragraph.
  7. Muat sebuah gambar ke dalam PPImage.
  8. Atur tipe bullet menjadi PPImage dan tetapkan gambar.
  9. Tetapkan teks paragraf.
  10. Atur indent paragraf untuk bullet.
  11. Atur warna bullet.
  12. Atur tinggi bullet.
  13. Tambahkan paragraf baru ke koleksi paragraf TextFrame.
  14. Tambahkan paragraf kedua dan ulangi langkah 8–12.
  15. Simpan presentasi.

Kode Python berikut menunjukkan cara menambahkan dan mengelola bullet gambar:

import aspose.slides as slides
import aspose.pydrawing as draw

with slides.Presentation() as presentation:

    # Akses slide pertama.
    slide = presentation.slides[0]

    # Muat gambar bullet.
    image = draw.Bitmap("bullets.png")
    pp_image = presentation.images.add_image(image)

    # Tambah dan akses AutoShape.
    auto_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # Akses TextFrame dari AutoShape yang dibuat.
    text_frame = auto_shape.text_frame

    # Hapus paragraf default.
    text_frame.paragraphs.remove_at(0)

    # Buat paragraf baru.
    paragraph = slides.Paragraph()
    paragraph.text = "Welcome to Aspose.Slides"

    # Atur jenis bullet paragraf menjadi Gambar dan tetapkan gambar.
    paragraph.paragraph_format.bullet.type = slides.BulletType.PICTURE
    paragraph.paragraph_format.bullet.picture.image = pp_image

    # Atur tinggi bullet.
    paragraph.paragraph_format.bullet.height = 100

    # Tambahkan paragraf ke teks frame.
    text_frame.paragraphs.add(paragraph)

    # Simpan presentasi sebagai file PPTX.
    presentation.save("picture_bullets_out.pptx", slides.export.SaveFormat.PPTX)
    # Simpan presentasi sebagai file PPT.
    presentation.save("picture_bullets_out.ppt", slides.export.SaveFormat.PPT)

Mengelola Bullet Multilevel

Daftar bullet membantu Anda mengatur dan menyajikan informasi dengan cepat dan efisien. Bullet multilevel mudah dibaca dan dipahami.

  1. Buat sebuah instance dari kelas Presentation.
  2. Akses slide target berdasarkan indeksnya.
  3. Tambahkan sebuah AutoShape ke slide.
  4. Akses TextFrame pada AutoShape.
  5. Hapus paragraf default dari TextFrame.
  6. Buat paragraf pertama menggunakan kelas Paragraph dan atur depth menjadi 0.
  7. Buat paragraf kedua menggunakan kelas Paragraph dan atur depth menjadi 1.
  8. Buat paragraf ketiga menggunakan kelas Paragraph dan atur depth menjadi 2.
  9. Buat paragraf keempat menggunakan kelas Paragraph dan atur depth menjadi 3.
  10. Tambahkan paragraf baru ke koleksi paragraf TextFrame.
  11. Simpan presentasi.

Kode Python berikut menunjukkan cara menambahkan dan mengelola bullet multilevel:

import aspose.slides as slides
import aspose.pydrawing as draw

# Buat instansi presentasi.
with slides.Presentation() as presentation:

    # Akses slide pertama.
    slide = presentation.slides[0]
    
    # Tambahkan AutoShape.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # Akses TextFrame dari AutoShape yang dibuat.
    text_frame = auto_shape.text_frame
    
    # Hapus paragraf default.
    text_frame.paragraphs.clear()

    # Tambahkan paragraf pertama.
    paragraph1 = slides.Paragraph()
    paragraph1.text = "Content"
    paragraph1.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph1.paragraph_format.bullet.char = chr(8226)
    paragraph1.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph1.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    # Atur level bullet.
    paragraph1.paragraph_format.depth = 0

    # Tambahkan paragraf kedua.
    paragraph2 = slides.Paragraph()
    paragraph2.text = "Second Level"
    paragraph2.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph2.paragraph_format.bullet.char = '-'
    paragraph2.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph2.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    # Atur level bullet.
    paragraph2.paragraph_format.depth = 1

    # Tambahkan paragraf ketiga.
    paragraph3 = slides.Paragraph()
    paragraph3.text = "Third Level"
    paragraph3.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph3.paragraph_format.bullet.char = chr(8226)
    paragraph3.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph3.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    # Atur level bullet.
    paragraph3.paragraph_format.depth = 2

    # Tambahkan paragraf keempat.
    paragraph4 = slides.Paragraph()
    paragraph4.text = "Fourth Level"
    paragraph4.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph4.paragraph_format.bullet.char = '-'
    paragraph4.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph4.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    # Atur level bullet.
    paragraph4.paragraph_format.depth = 3

    # Tambahkan paragraf ke koleksi.
    text_frame.paragraphs.add(paragraph1)
    text_frame.paragraphs.add(paragraph2)
    text_frame.paragraphs.add(paragraph3)
    text_frame.paragraphs.add(paragraph4)

    # Simpan presentasi sebagai file PPTX.
    presentation.save("multilevel_bullets_out.pptx", slides.export.SaveFormat.PPTX)

Mengelola Paragraf dengan Daftar Bernomor Kustom

Kelas BulletFormat menyediakan properti numbered_bullet_start_with (dan lainnya) untuk mengontrol penomoran kustom serta pemformatan paragraf.

  1. Buat sebuah instance dari kelas Presentation.
  2. Akses slide yang akan berisi paragraf‑paragraf.
  3. Tambahkan sebuah AutoShape ke slide.
  4. Akses TextFrame pada shape tersebut.
  5. Hapus paragraf default dari TextFrame.
  6. Buat Paragraph pertama dan atur numbered_bullet_start_with menjadi 2.
  7. Buat Paragraph kedua dan atur numbered_bullet_start_with menjadi 3.
  8. Buat Paragraph ketiga dan atur numbered_bullet_start_with menjadi 7.
  9. Tambahkan paragraf‑paragraf ke koleksi TextFrame.
  10. Simpan presentasi.

Kode Python berikut mendemonstrasikan cara menambahkan dan mengelola paragraf dengan penomoran serta pemformatan kustom.

import aspose.slides as slides

with slides.Presentation() as presentation:

    # Tambahkan dan akses AutoShape.
    shape = presentation.slides[0].shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # Akses TextFrame dari AutoShape yang dibuat.
    text_frame = shape.text_frame

    # Hapus paragraf default yang ada.
    text_frame.paragraphs.remove_at(0)

    # Buat item bernomor pertama (mulai dari 2, tingkat kedalaman 4).
    paragraph1 = slides.Paragraph()
    paragraph1.text = "bullet 2"
    paragraph1.paragraph_format.depth = 4 
    paragraph1.paragraph_format.bullet.numbered_bullet_start_with = 2
    paragraph1.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    text_frame.paragraphs.add(paragraph1)

    # Buat item bernomor kedua (mulai dari 3, tingkat kedalaman 4).
    paragraph2 = slides.Paragraph()
    paragraph2.text = "bullet 3"
    paragraph2.paragraph_format.depth = 4
    paragraph2.paragraph_format.bullet.numbered_bullet_start_with = 3 
    paragraph2.paragraph_format.bullet.type = slides.BulletType.NUMBERED  
    text_frame.paragraphs.add(paragraph2)

    # Buat item bernomor ketiga (mulai dari 7, tingkat kedalaman 4).
    paragraph5 = slides.Paragraph()
    paragraph5.text = "bullet 7"
    paragraph5.paragraph_format.depth = 4
    paragraph5.paragraph_format.bullet.numbered_bullet_start_with = 7
    paragraph5.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    text_frame.paragraphs.add(paragraph5)

    presentation.save("custom_bullets_out.pptx", slides.export.SaveFormat.PPTX)

Atur Indent Baris Pertama untuk Paragraf

Gunakan properti ParagraphFormat.indent untuk mengontrol indent baris pertama suatu paragraf. Properti ini hanya memindahkan baris pertama relatif terhadap margin kiri paragraf. Nilai positif menggeser baris pertama ke kanan, sedangkan baris lainnya tetap sejajar dengan isi paragraf.

Gunakan ParagraphFormat.margin_left bila Anda perlu memindahkan seluruh paragraf. Gunakan ParagraphFormat.indent bila Anda hanya ingin memindahkan baris pertama.

Contoh berikut membuat beberapa paragraf dan menerapkan nilai indent yang berbeda untuk menunjukkan pengaruh indent baris pertama pada tata letak paragraf.

  1. Buat sebuah instance dari kelas Presentation.
  2. Akses slide target.
  3. Tambahkan sebuah AutoShape berbentuk persegi panjang ke slide.
  4. Tambahkan sebuah TextFrame kosong ke shape dan hapus paragraf default.
  5. Buat beberapa paragraf dan atur nilai indent yang berbeda untuk masing‑masing.
  6. Tambahkan paragraf‑paragraf ke bingkai teks.
  7. Simpan presentasi yang telah dimodifikasi.

Kode ini menunjukkan cara mengatur indent paragraf:

import aspose.slides as slides
import aspose.pydrawing as draw

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    rectangle = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 420, 220)
    rectangle.fill_format.fill_type = slides.FillType.NO_FILL
    rectangle.line_format.fill_format.fill_type = slides.FillType.SOLID
    rectangle.line_format.fill_format.solid_fill_color.color = draw.Color.gray

    text_frame = rectangle.add_text_frame("")
    text_frame.text_frame_format.autofit_type = slides.TextAutofitType.SHAPE
    text_frame.paragraphs.remove_at(0)

    first_paragraph = slides.Paragraph()
    first_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    first_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    first_paragraph.text = "No first-line indent. Wrapped lines start at the same position as the first line."
    first_paragraph.paragraph_format.margin_left = 20.0
    first_paragraph.paragraph_format.indent = 0.0

    second_paragraph = slides.Paragraph()
    second_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    second_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    second_paragraph.text = "First-line indent of 20 points. The first line moves to the right, while wrapped lines remain aligned to the paragraph body."
    second_paragraph.paragraph_format.margin_left = 20.0
    second_paragraph.paragraph_format.indent = 20.0

    third_paragraph = slides.Paragraph()
    third_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    third_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    third_paragraph.text = "First-line indent of 40 points. This paragraph shows a larger first-line offset to make the effect easier to see."
    third_paragraph.paragraph_format.margin_left = 20.0
    third_paragraph.paragraph_format.indent = 40.0

    text_frame.paragraphs.add(first_paragraph)
    text_frame.paragraphs.add(second_paragraph)
    text_frame.paragraphs.add(third_paragraph)

    presentation.save("paragraph_indent.pptx", slides.export.SaveFormat.PPTX)

Hasil:

Indent baris pertama dari paragraf

Atur Indent Gantung untuk Paragraf

Indent gantung adalah tata letak paragraf dimana baris pertama dimulai lebih ke kiri dibandingkan dengan baris‑baris berikutnya. Di Aspose.Slides, efek ini dibuat dengan properti ParagraphFormat.indent. Atur indent ke nilai negatif untuk memindahkan baris pertama ke kiri relatif terhadap isi paragraf.

Secara praktis, ParagraphFormat.margin_left menentukan posisi kiri isi paragraf, dan ParagraphFormat.indent menentukan posisi baris pertama relatif terhadap margin tersebut. Untuk membuat indent gantung, setel nilai margin_left positif dan nilai indent negatif.

Pemformatan ini berguna untuk bibliografi, referensi, entri glosarium, dan paragraf lain dimana baris‑baris yang dibungkus harus sejajar di bawah isi paragraf, bukan di bawah karakter pertama baris pertama.

  1. Buat sebuah instance dari kelas Presentation.
  2. Akses slide target.
  3. Tambahkan sebuah AutoShape berbentuk persegi panjang ke slide.
  4. Tambahkan sebuah TextFrame kosong ke shape dan hapus paragraf default.
  5. Buat paragraf‑paragraf dan atur nilai margin_left positif untuk masing‑masing.
  6. Atur nilai indent negatif untuk menciptakan efek indent gantung.
  7. Tambahkan paragraf‑paragraf ke bingkai teks.
  8. Simpan presentasi yang telah dimodifikasi.

Kode ini menunjukkan cara mengatur indent gantung untuk paragraf:

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    rectangle = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 420, 220)
    rectangle.fill_format.fill_type = slides.FillType.NO_FILL
    rectangle.line_format.fill_format.fill_type = slides.FillType.SOLID
    rectangle.line_format.fill_format.solid_fill_color.color = draw.Color.gray

    text_frame = rectangle.add_text_frame("")
    text_frame.text_frame_format.autofit_type = slides.TextAutofitType.SHAPE
    text_frame.paragraphs.remove_at(0)

    first_paragraph = slides.Paragraph()
    first_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    first_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    first_paragraph.text = "A hanging indent is created by combining a positive left margin with a negative indent. The first line starts to the left, while wrapped lines align with the paragraph body."
    first_paragraph.paragraph_format.margin_left = 40.0
    first_paragraph.paragraph_format.indent = -20.0

    second_paragraph = slides.Paragraph()
    second_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    second_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    second_paragraph.text = "This second example uses a deeper hanging indent so the difference between the first line and the wrapped lines is easier to compare."
    second_paragraph.paragraph_format.margin_left = 60.0
    second_paragraph.paragraph_format.indent = -30.0

    text_frame.paragraphs.add(first_paragraph)
    text_frame.paragraphs.add(second_paragraph)

    presentation.save("hanging_indent.pptx", slides.export.SaveFormat.PPTX)

Hasil:

Indent gantung dari paragraf

Kelola Format Bagian Akhir Paragraf

Ketika Anda perlu mengontrol gaya “akhir” sebuah paragraf (pemformatan yang diterapkan setelah bagian teks terakhir), gunakan properti end_paragraph_portion_format. Contoh di bawah menerapkan font Times New Roman ukuran lebih besar pada akhir paragraf kedua.

  1. Buat atau buka file Presentation.
  2. Dapatkan slide target berdasarkan indeks.
  3. Tambahkan sebuah AutoShape persegi panjang ke slide.
  4. Gunakan TextFrame pada shape dan buat dua paragraf.
  5. Buat sebuah PortionFormat dengan ukuran 48 pt Times New Roman dan terapkan sebagai format bagian akhir paragraf.
  6. Tetapkan ke end_paragraph_portion_format paragraf (berlaku pada akhir paragraf kedua).
  7. Tulis presentasi yang telah dimodifikasi sebagai file PPTX.

Kode Python berikut menunjukkan cara mengatur format akhir paragraf untuk paragraf kedua:

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
	shape = presentation.slides[0].shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 200, 250)

	paragraph1 = slides.Paragraph()
	paragraph1.portions.add(slides.Portion("Sample text"))

	end_paragraph_portion_format = slides.PortionFormat()
	end_paragraph_portion_format.font_height = 48
	end_paragraph_portion_format.latin_font = slides.FontData("Times New Roman")

	paragraph2 = slides.Paragraph()
	paragraph2.portions.add(slides.Portion("Sample text 2"))
	paragraph2.end_paragraph_portion_format = end_paragraph_portion_format

	shape.text_frame.paragraphs.add(paragraph1)
	shape.text_frame.paragraphs.add(paragraph2)

	presentation.save("presentation.pptx", slides.export.SaveFormat.PPTX)

Impor Teks HTML ke dalam Paragraf

Aspose.Slides menyediakan dukungan yang ditingkatkan untuk mengimpor teks HTML ke dalam paragraf.

  1. Buat sebuah instance dari kelas Presentation.
  2. Akses slide target berdasarkan indeksnya.
  3. Tambahkan sebuah AutoShape ke slide.
  4. Akses TextFrame pada AutoShape.
  5. Hapus paragraf default dari TextFrame.
  6. Baca file HTML sumber.
  7. Buat paragraf pertama menggunakan kelas Paragraph.
  8. Tambahkan konten HTML ke koleksi paragraf TextFrame.
  9. Simpan presentasi yang telah dimodifikasi.

Kode Python berikut mengimplementasikan langkah‑langkah tersebut untuk mengimpor teks HTML ke dalam paragraf.

import aspose.slides as slides

# Buat instansi Presentation kosong.
with slides.Presentation() as presentation:

    # Akses slide pertama dari presentasi.
    slide = presentation.slides[0]

    slide_width = presentation.slide_size.size.width
    slide_height = presentation.slide_size.size.height

    # Tambahkan AutoShape untuk menampung konten HTML.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, slide_width - 20, slide_height - 10)

    # Hapus semua paragraf di text frame yang ditambahkan.
    shape.text_frame.paragraphs.clear()

    # Muat file HTML.
    with open("file.html", "rt") as html_stream:
        # Tambahkan teks dari file HTML ke text frame.
        shape.text_frame.paragraphs.add_from_html(html_stream.read())

    # Simpan presentasi.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Ekspor Teks Paragraf ke HTML

Aspose.Slides menyediakan dukungan yang ditingkatkan untuk mengekspor teks ke HTML.

  1. Buat sebuah instance dari kelas Presentation dan muat presentasi target.
  2. Akses slide yang diinginkan berdasarkan indeksnya.
  3. Pilih shape yang berisi teks yang akan diekspor.
  4. Akses TextFrame pada shape tersebut.
  5. Buka aliran file untuk menulis output HTML.
  6. Tentukan indeks mulai dan ekspor paragraf‑paragraf yang diperlukan.

Contoh Python ini menunjukkan cara mengekspor teks paragraf ke HTML.

import aspose.slides as slides

# Muat file presentasi.
with slides.Presentation("exporting_HTML_text.pptx") as presentation:
    # Akses slide pertama dari presentasi.
    slide = presentation.slides[0]

    # Indeks shape target.
    index = 0

    # Akses shape berdasarkan indeks.
    shape = slide.shapes[index]

    with open("output.html", "w") as html_stream:
        # Tulis data paragraf ke HTML dengan memberikan indeks paragraf mulai dan total jumlah paragraf yang akan diekspor.
        html_stream.write(shape.text_frame.paragraphs.export_to_html(0, shape.text_frame.paragraphs.count, None))

Simpan Paragraf sebagai Gambar

Di bagian ini, kami akan mengeksplorasi dua contoh yang menunjukkan cara menyimpan sebuah paragraf teks, yang direpresentasikan oleh kelas Paragraph, sebagai gambar. Kedua contoh mencakup memperoleh gambar shape yang berisi paragraf menggunakan metode get_image dari kelas Shape, menghitung batas paragraf di dalam shape, dan mengekspornya sebagai gambar bitmap. Pendekatan ini memungkinkan Anda mengekstrak bagian‑bagian tertentu dari teks presentasi PowerPoint dan menyimpannya sebagai gambar terpisah, yang dapat berguna untuk penggunaan lebih lanjut dalam berbagai skenario.

Anggap kami memiliki file presentasi bernama sample.pptx dengan satu slide, di mana shape pertama adalah kotak teks yang berisi tiga paragraf.

Kotak teks dengan tiga paragraf

Contoh 1

Pada contoh ini, kami memperoleh paragraf kedua sebagai gambar. Untuk melakukannya, kami mengekstrak gambar shape dari slide pertama presentasi, lalu menghitung batas paragraf kedua dalam bingkai teks shape. Paragraf tersebut kemudian digambar ulang ke gambar bitmap baru, yang disimpan dalam format PNG. Metode ini sangat berguna ketika Anda perlu menyimpan paragraf tertentu sebagai gambar terpisah sambil mempertahankan dimensi dan pemformatan teks yang tepat.

import aspose.slides as slides
import math
import io
from PIL import Image

with slides.Presentation("sample.pptx") as presentation:
    first_shape = presentation.slides[0].shapes[0]

    # Simpan shape di memori sebagai bitmap.
    with first_shape.get_image() as shape_image:
        shape_image_stream = io.BytesIO()
        shape_image.save(shape_image_stream, slides.ImageFormat.PNG)

    # Buat bitmap shape dari memori.
    shape_image_stream.seek(0)
    shape_bitmap = Image.open(shape_image_stream)

    # Hitung batas paragraf kedua.
    second_paragraph = first_shape.text_frame.paragraphs[1]
    paragraph_rectangle = second_paragraph.get_rect()

    # Hitung koordinat dan ukuran untuk gambar output (ukuran minimum - 1x1 piksel).
    image_left = math.floor(paragraph_rectangle.x)
    image_top = math.floor(paragraph_rectangle.y)
    image_right = image_left + max(1, math.ceil(paragraph_rectangle.width))
    image_bottom = image_top + max(1, math.ceil(paragraph_rectangle.height))

    # Potong bitmap shape untuk mendapatkan bitmap paragraf saja.
    paragraph_bitmap = shape_bitmap.crop((image_left, image_top, image_right, image_bottom))

    paragraph_bitmap.save("paragraph.png")

Hasil:

Gambar paragraf

Contoh 2

Pada contoh ini, kami memperluas pendekatan sebelumnya dengan menambahkan faktor skala pada gambar paragraf. Shape diekstrak dari presentasi dan disimpan sebagai gambar dengan faktor skala 2. Ini memungkinkan keluaran resolusi lebih tinggi saat mengekspor paragraf. Batas paragraf kemudian dihitung dengan memperhitungkan skala. Skalasi dapat sangat berguna ketika diperlukan gambar yang lebih detail, misalnya untuk penggunaan dalam materi cetak berkualitas tinggi.

import aspose.slides as slides
import math
import io
from PIL import Image

image_scale_x = 2
image_scale_y = image_scale_x

with slides.Presentation("sample.pptx") as presentation:
    first_shape = presentation.slides[0].shapes[0]

    # Simpan shape di memori sebagai bitmap.
    with first_shape.get_image(slides.ShapeThumbnailBounds.SHAPE, image_scale_x, image_scale_y) as shape_image:
        shape_image_stream = io.BytesIO()
        shape_image.save(shape_image_stream, slides.ImageFormat.PNG)

    # Buat bitmap shape dari memori.
    shape_image_stream.seek(0)
    shape_bitmap = Image.open(shape_image_stream)

    # Hitung batas paragraf kedua.
    second_paragraph = first_shape.text_frame.paragraphs[1]
    paragraph_rectangle = second_paragraph.get_rect()
    paragraph_rectangle.x *= image_scale_x
    paragraph_rectangle.y *= image_scale_y
    paragraph_rectangle.width *= image_scale_x
    paragraph_rectangle.height *= image_scale_y

    # Hitung koordinat dan ukuran untuk gambar output (ukuran minimum - 1x1 piksel).
    image_left = math.floor(paragraph_rectangle.x)
    image_top = math.floor(paragraph_rectangle.y)
    image_right = image_left + max(1, math.ceil(paragraph_rectangle.width))
    image_bottom = image_top + max(1, math.ceil(paragraph_rectangle.height))

    # Potong bitmap shape untuk mendapatkan bitmap paragraf saja.
    paragraph_bitmap = shape_bitmap.crop((image_left, image_top, image_right, image_bottom))

    paragraph_bitmap.save("paragraph.png")

FAQ

Apakah saya dapat sepenuhnya menonaktifkan pembungkusan baris di dalam sebuah TextFrame?

Ya. Gunakan pengaturan pembungkusan TextFrame (wrap_text) untuk mematikan pembungkusan sehingga baris tidak akan terputus di tepi frame.

Bagaimana cara mendapatkan batas tepat pada slide untuk paragraf tertentu?

Anda dapat mengambil kotak pembatas (bounding rectangle) paragraf (bahkan bagian tunggal) untuk mengetahui posisi dan ukuran yang tepat pada slide.

Di mana kontrol penyelarasan paragraf (kiri/kanan/tengah/justify) berada?

Alignment adalah pengaturan tingkat paragraf di ParagraphFormat; ia berlaku untuk seluruh paragraf terlepas dari pemformatan bagian individual.

Apakah saya dapat mengatur bahasa pemeriksa ejaan hanya untuk bagian tertentu dari sebuah paragraf (misalnya satu kata)?

Ya. Bahasa diatur pada tingkat bagian (PortionFormat.language_id), sehingga beberapa bahasa dapat hidup berdampingan dalam satu paragraf.

Tingkatkan Presentasi Anda dengan AutoFit di Python Dapatkan Batas Paragraf dari Presentasi di Python