Kelola Baris dan Kolom pada Tabel PowerPoint Menggunakan Python

Tentang apa halaman ini

Kelola baris dan kolom tabel di PowerPoint dengan Aspose.Slides untuk Python via Java dan percepat pengeditan presentasi serta pembaruan data.

Pendahuluan

Aspose.Slides for Python via Java memungkinkan Anda mengelola struktur tabel dan pemformatan dalam presentasi PowerPoint melalui kelas Table. Anda dapat menetapkan baris header, menggandakan atau menghapus baris dan kolom, serta menerapkan pemformatan teks ke seluruh baris atau kolom.

Artikel ini menjelaskan operasi tersebut dengan contoh Python. Artikel ini juga menunjukkan cara mengambil preset gaya tabel sehingga Anda dapat menggunakannya kembali. Indeks baris dan kolom tabel mulai dari nol.

Mengontrol Tinggi Baris

Gunakan Row.setMinimalHeight untuk menetapkan tinggi minimum sebuah baris dalam poin. Ini merupakan batas bawah, bukan tinggi tetap. Row.getHeight mengembalikan tinggi sebenarnya. Akses baris melalui Table.getRows.

Contoh memuat row-height-input.pptx, yang berisi tabel sebagai bentuk pertama pada slide pertama. Baris pertamanya dimulai pada 70 poin. Sel‑sel menggunakan teks Arial 18 poin, membungkus, dan margin atas serta bawah 6 poin; teks yang lebih panjang pada kolom kedua membungkus menjadi beberapa baris. Contoh meningkatkan minimum menjadi 100 poin, lalu menurunkannya menjadi 20 poin, mencetak tinggi sebenarnya setelah setiap perubahan, dan menyimpan kedua hasilnya.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("row-height-input.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    table = slide.getShapes().get_Item(0)
    row = table.getRows().get_Item(0)

    row.setMinimalHeight(100)
    print(f"Increased: minimum = {row.getMinimalHeight():.1f}, actual = {row.getHeight():.1f} pt")
    presentation.save("row-height-increased.pptx", SaveFormat.Pptx)

    row.setMinimalHeight(20)
    print(f"Decreased: minimum = {row.getMinimalHeight():.1f}, actual = {row.getHeight():.1f} pt")
    presentation.save("row-height-decreased.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Dengan presentasi yang disediakan, meningkatkan minimum menambah ruang pada baris. Menurunkannya menghapus ruang tambahan tersebut, tetapi tinggi sebenarnya tetap lebih besar dari 20 poin karena teks dan margin sel memerlukan ruang lebih. Mengurangi minimum saja tidak dapat memaksa baris berada di bawah ruang yang dibutuhkan oleh isinya.

Beberapa faktor memengaruhi tinggi sebenarnya:

Teks dan ukuran font: teks yang lebih panjang, jeda baris eksplisit, atau font yang lebih besar dapat memerlukan lebih banyak ruang vertikal.
Pembungkus dan lebar kolom: dengan pembungkus diaktifkan, mengurangi lebar kolom menggunakan Column.setWidth dapat menghasilkan lebih banyak baris. Kolom yang lebih lebar dapat mengurangi ruang yang diperlukan secara vertikal.
Margin sel: Cell.setMarginTop dan Cell.setMarginBottom menambah ruang vertikal. Cell.setMarginLeft dan Cell.setMarginRight mengurangi lebar yang tersedia untuk teks dan dapat menyebabkan pembungkus tambahan.

Untuk tabel ini tanpa sel yang digabung, sel yang membutuhkan ruang vertikal paling banyak menentukan batas bawah yang ditentukan konten untuk seluruh baris. Agar baris menjadi lebih pendek, Anda mungkin juga perlu memendekkan teks, mengurangi ukuran font atau margin, atau memperlebar kolom.

Gambar di bawah menunjukkan tabel yang sama pada skala yang sama. Pada hasil yang diilustrasikan, tinggi sebenarnya adalah 70, 100, dan 55,2 poin: baris terakhir tetap lebih tinggi daripada minimum 20 poin. Pengukuran teks yang tepat dapat bervariasi tergantung pada font yang tersedia di lingkungan Anda. Unduh hasil yang disimpan: increased minimum dan decreased minimum.

Asli: minimum 70 pt, aktual 70 pt	Ditambah: minimum 100 pt, aktual 100 pt	Dikurangi: minimum 20 pt, aktual 55.2 pt

Menetapkan Baris Pertama sebagai Header

Gunakan metode setFirstRow untuk menandai baris pertama agar diformat sebagai header. Penampilannya tergantung pada gaya tabel yang diterapkan pada tabel.

Muat presentasi dengan kelas Presentation.
Akses slide pertama.
Akses tabel yang disimpan sebagai bentuk pertama pada slide.
Aktifkan pemformatan header untuk baris pertamanya.
Simpan presentasi yang telah dimodifikasi.

Contoh memerlukan table.pptx dengan tabel sebagai bentuk pertama pada slide pertama. Contoh mengaktifkan pemformatan header untuk baris pertama dan menyimpan First_row_header.pptx.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("table.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    table = slide.getShapes().get_Item(0)
    table.setFirstRow(True)

    presentation.save("First_row_header.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Menggandakan Baris atau Kolom Tabel

Gandakan baris atau kolom untuk menggunakan kembali konten dan pemformatannya. Anda dapat menambahkan salinan ke akhir tabel atau menyisipkannya pada posisi tertentu.

Muat presentasi dengan kelas Presentation.
Akses slide pertama.
Tentukan lebar kolom dan tinggi baris.
Tambahkan tabel dengan metode addTable.
Gandakan baris yang diperlukan.
Gandakan kolom yang diperlukan.
Simpan presentasi yang telah dimodifikasi.

Contoh memerlukan Test.pptx dengan setidaknya satu slide. Contoh membuat tabel dengan tiga kolom dan lima baris, dengan dimensi yang ditentukan dalam poin. Contoh menambahkan salinan baris pertama dan kolom pertama, kemudian menyisipkan salinan baris kedua dan kolom kedua pada indeks 3 (posisi keempat). Tabel yang dihasilkan memiliki tujuh baris dan lima kolom. Argumen False menonaktifkan penggandaan ke baris atau kolom yang digabung berdekatan; tabel ini tidak memiliki sel yang digabung.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("Test.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    column_widths = jpype.JArray(jpype.JDouble)([50, 50, 50])
    row_heights = jpype.JArray(jpype.JDouble)([50, 30, 30, 30, 30])
    table = slide.getShapes().addTable(100, 50, column_widths, row_heights)

    table.get_Item(0, 0).getTextFrame().setText("Row 1 Cell 1")
    table.get_Item(1, 0).getTextFrame().setText("Row 1 Cell 2")
    table.getRows().addClone(table.getRows().get_Item(0), False)

    table.get_Item(0, 1).getTextFrame().setText("Row 2 Cell 1")
    table.get_Item(1, 1).getTextFrame().setText("Row 2 Cell 2")
    table.getRows().insertClone(3, table.getRows().get_Item(1), False)

    table.getColumns().addClone(table.getColumns().get_Item(0), False)
    table.getColumns().insertClone(3, table.getColumns().get_Item(1), False)

    presentation.save("table_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Menghapus Baris atau Kolom dari Tabel

Hapus baris atau kolom yang tidak lagi diperlukan dalam sebuah tabel. Menghapus sebuah item menggeser indeks baris atau kolom yang mengikutinya.

Buat presentasi dengan kelas Presentation.
Akses slide pertama.
Tentukan lebar kolom dan tinggi baris.
Tambahkan tabel dengan metode addTable.
Hapus baris kedua dan kolom kedua.
Simpan presentasi yang telah dimodifikasi.

Contoh ini membuat tabel tiga‑by‑tiga dan menghapus baris serta kolom pada indeks 1, menghasilkan tabel dua‑by‑dua dalam TestTable_out.pptx. Dimensi dalam poin. Argumen False menonaktifkan penghapusan pada baris atau kolom yang digabung berdekatan; tabel ini tidak memiliki sel yang digabung.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    column_widths = jpype.JArray(jpype.JDouble)([100, 50, 30])
    row_heights = jpype.JArray(jpype.JDouble)([30, 50, 30])
    table = slide.getShapes().addTable(100, 100, column_widths, row_heights)

    table.getRows().removeAt(1, False)
    table.getColumns().removeAt(1, False)

    presentation.save("TestTable_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Menetapkan Pemformatan Teks pada Tingkat Baris Tabel

Terapkan pemformatan teks ke seluruh baris agar sel‑selnya konsisten. Anda dapat mengatur properti font, pemformatan paragraf, dan arah teks tanpa harus memformat setiap sel secara terpisah.

Muat presentasi dengan kelas Presentation.
Akses tabel pada slide pertama.
Gunakan setFontHeight untuk baris pertama.
Gunakan setAlignment dan setMarginRight untuk baris pertama.
Gunakan setTextVerticalType untuk baris kedua.
Simpan presentasi yang telah dimodifikasi.

Contoh memerlukan table.pptx dengan tabel sebagai bentuk pertama pada slide pertama dan setidaknya dua baris. Contoh menerapkan teks 25 poin, perataan kanan, dan margin paragraf kanan 20 poin pada baris pertama, kemudian mengatur teks vertikal pada baris kedua.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, PortionFormat, ParagraphFormat, TextFrameFormat, TextAlignment, TextVerticalType

presentation = Presentation("table.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    table = slide.getShapes().get_Item(0)

    portion_format = PortionFormat()
    portion_format.setFontHeight(25)
    table.getRows().get_Item(0).setTextFormat(portion_format)

    paragraph_format = ParagraphFormat()
    paragraph_format.setAlignment(TextAlignment.Right)
    paragraph_format.setMarginRight(20)
    table.getRows().get_Item(0).setTextFormat(paragraph_format)

    text_frame_format = TextFrameFormat()
    text_frame_format.setTextVerticalType(TextVerticalType.Vertical)
    table.getRows().get_Item(1).setTextFormat(text_frame_format)

    presentation.save("row_formatting.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Menetapkan Pemformatan Teks pada Tingkat Kolom Tabel

Terapkan pemformatan teks ke seluruh kolom agar sel‑selnya konsisten. Anda dapat mengatur properti font, pemformatan paragraf, dan arah teks tanpa harus memformat setiap sel secara terpisah.

Muat presentasi dengan kelas Presentation.
Akses tabel pada slide pertama.
Gunakan setFontHeight untuk kolom pertama.
Gunakan setAlignment dan setMarginRight untuk kolom pertama.
Gunakan setTextVerticalType untuk kolom kedua.
Simpan presentasi yang telah dimodifikasi.

Contoh memerlukan table.pptx dengan tabel sebagai bentuk pertama pada slide pertama dan setidaknya dua kolom. Contoh menerapkan teks 25 poin, perataan kanan, dan margin paragraf kanan 20 poin pada kolom pertama, kemudian mengatur teks vertikal pada kolom kedua.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, PortionFormat, ParagraphFormat, TextFrameFormat, TextAlignment, TextVerticalType

presentation = Presentation("table.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    table = slide.getShapes().get_Item(0)

    portion_format = PortionFormat()
    portion_format.setFontHeight(25)
    table.getColumns().get_Item(0).setTextFormat(portion_format)

    paragraph_format = ParagraphFormat()
    paragraph_format.setAlignment(TextAlignment.Right)
    paragraph_format.setMarginRight(20)
    table.getColumns().get_Item(0).setTextFormat(paragraph_format)

    text_frame_format = TextFrameFormat()
    text_frame_format.setTextVerticalType(TextVerticalType.Vertical)
    table.getColumns().get_Item(1).setTextFormat(text_frame_format)

    presentation.save("column_formatting.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Mendapatkan Properti Gaya Tabel

Gunakan metode getStylePreset untuk mengambil preset yang diterapkan pada sebuah tabel dan menggunakannya kembali pada tabel lain. Ini mengidentifikasi preset alih‑alih format‑override sel individu.

Contoh membuat tabel, menerapkan TableStylePreset.DarkStyle1, dan membaca kembali preset tersebut. Contoh mencetak nilai integer yang sesuai dengan DarkStyle1 dan menyimpan tabel dalam table.pptx.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, TableStylePreset

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    column_widths = jpype.JArray(jpype.JDouble)([100, 150])
    row_heights = jpype.JArray(jpype.JDouble)([5, 5, 5])
    table = slide.getShapes().addTable(10, 10, column_widths, row_heights)
    table.setStylePreset(TableStylePreset.DarkStyle1)

    style_preset = table.getStylePreset()
    print(style_preset)

    presentation.save("table.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

FAQ

Apakah saya dapat menerapkan tema/gaya PowerPoint ke tabel yang sudah dibuat?

Ya. Tabel mewarisi tema slide/layout/master, dan Anda masih dapat menimpa isian, batas, dan warna teks di atas tema tersebut.

Apakah saya dapat mengurutkan baris tabel seperti di Excel?

Tidak, tabel Aspose.Slides tidak memiliki penyortiran atau filter bawaan. Urutkan data di memori terlebih dahulu, kemudian isi kembali baris tabel dalam urutan tersebut.

Apakah saya dapat memiliki kolom berpita (striped) sambil mempertahankan warna khusus pada sel tertentu?

Ya. Aktifkan kolom berpita, lalu timpa sel‑sel tertentu dengan format lokal; format pada tingkat sel memiliki prioritas lebih tinggi daripada gaya tabel.

Kelola Tabel Presentasi dalam Python Kelola Sel Tabel dalam Presentasi Menggunakan Python