Mengelola Baris dan Kolom dalam Tabel PowerPoint Menggunakan Java

Pendahuluan

Aspose.Slides for Java memungkinkan Anda mengelola struktur tabel dan pemformatan dalam presentasi PowerPoint melalui kelas Table dan antarmuka ITable. 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 Java. Ini juga menunjukkan cara mengambil preset gaya tabel sehingga Anda dapat menggunakannya kembali. Indeks baris dan kolom tabel berbasis nol.

Mengontrol Tinggi Baris

Gunakan IRow.setMinimalHeight untuk menetapkan tinggi minimum baris dalam poin. Itu merupakan batas bawah, bukan tinggi tetap. IRow.getHeight mengembalikan tinggi sebenarnya. Akses baris melalui ITable.getRows.

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

import com.aspose.slides.*;

Presentation presentation = new Presentation("row-height-input.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ITable table = (ITable)slide.getShapes().get_Item(0);
    IRow row = table.getRows().get_Item(0);

    row.setMinimalHeight(100);
    System.out.printf("Increased: minimum = %.1f, actual = %.1f pt%n", row.getMinimalHeight(), row.getHeight());
    presentation.save("row-height-increased.pptx", SaveFormat.Pptx);

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

Dengan presentasi yang disediakan, meningkatkan minimum menambahkan ruang ke baris. Menurunkannya menghapus ruang ekstra tersebut, namun tinggi sebenarnya tetap lebih besar dari 20 poin karena teks dan margin sel membutuhkan lebih banyak ruang. 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, pemisah baris eksplisit, atau font yang lebih besar dapat memerlukan lebih banyak ruang vertikal.
  • Pembungkus dan lebar kolom: dengan pembungkus diaktifkan, mengurangi lebar kolom dengan IColumn.setWidth dapat menghasilkan lebih banyak baris. Kolom yang lebih lebar dapat mengurangi ruang yang diperlukan secara vertikal.
  • Margin sel: ICell.setMarginTop dan ICell.setMarginBottom menambahkan ruang vertikal. ICell.setMarginLeft dan ICell.setMarginRight mengurangi lebar yang tersedia untuk teks dan dapat menyebabkan pembungkus tambahan.

Untuk tabel ini tanpa sel yang digabung, sel yang memerlukan ruang vertikal paling banyak menentukan batas bawah yang ditentukan konten untuk seluruh baris. Untuk membuat baris 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. Dalam hasil yang diilustrasikan, tinggi sebenarnya adalah 70, 100, dan 55,2 poin: baris akhir tetap lebih tinggi daripada minimum 20 poin. Pengukuran teks yang tepat dapat bervariasi dengan font yang tersedia di lingkungan Anda. Unduh hasil yang disimpan: minimum yang ditingkatkan dan minimum yang dikurangi.

Asli: minimum 70 pt, aktual 70 pt Ditingkatkan: minimum 100 pt, aktual 100 pt Diturunkan: minimum 20 pt, aktual 55.2 pt
Tabel asli dengan baris pertama 70 poin. Tabel setelah meningkatkan minimum baris pertama menjadi 100 poin. Tabel setelah menurunkan minimum baris pertama menjadi 20 poin; teks yang dibungkus membuat baris tetap lebih tinggi daripada minimum.

Tetapkan Baris Pertama sebagai Header

Gunakan metode setFirstRow untuk menandai baris pertama sebagai format header. Penampilannya bergantung pada gaya tabel yang diterapkan pada tabel.

  1. Muat presentasi dengan kelas Presentation.
  2. Akses slide pertama.
  3. Akses tabel yang disimpan sebagai bentuk pertama pada slide.
  4. Aktifkan format header untuk baris pertamanya.
  5. Simpan presentasi yang telah dimodifikasi.

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

import com.aspose.slides.*;

Presentation presentation = new Presentation("table.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ITable table = (ITable)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.

  1. Muat presentasi dengan kelas Presentation.
  2. Akses slide pertama.
  3. Tentukan lebar kolom dan tinggi baris.
  4. Tambahkan tabel dengan metode addTable.
  5. Gandakan baris yang diperlukan.
  6. Gandakan kolom yang diperlukan.
  7. Simpan presentasi yang telah dimodifikasi.

Contoh ini memerlukan Test.pptx dengan setidaknya satu slide. Itu membuat tabel dengan tiga kolom dan lima baris, dengan dimensi yang ditentukan dalam poin. Ia 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 bersebelahan; tabel ini tidak memiliki sel yang digabung.

import com.aspose.slides.*;

Presentation presentation = new Presentation("Test.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = new double[] { 50, 50, 50 };
    double[] rowHeights = new double[] { 50, 30, 30, 30, 30 };
    ITable table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    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 tabel. Menghapus sebuah item menggeser indeks baris atau kolom yang mengikutinya.

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

Contoh ini membuat tabel tiga-per-tiga dan menghapus baris serta kolom pada indeks 1, meninggalkan tabel dua-per-dua dalam TestTable_out.pptx. Dimensi dalam poin. Argumen false menonaktifkan penghapusan baris atau kolom yang digabung bersebelahan; tabel ini tidak memiliki sel yang digabung.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = new double[] { 100, 50, 30 };
    double[] rowHeights = new double[] { 30, 50, 30 };
    ITable table = slide.getShapes().addTable(100, 100, columnWidths, rowHeights);

    table.getRows().removeAt(1, false);
    table.getColumns().removeAt(1, false);

    presentation.save("TestTable_out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Atur Pemformatan Teks pada Tingkat Baris Tabel

Terapkan pemformatan teks pada seluruh baris untuk menjaga konsistensi sel-selnya. Anda dapat mengatur properti font, pemformatan paragraf, dan arah teks tanpa memformat setiap sel secara terpisah.

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

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

import com.aspose.slides.*;

Presentation presentation = new Presentation("table.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

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

    PortionFormat portionFormat = new PortionFormat();
    portionFormat.setFontHeight(25);
    table.getRows().get_Item(0).setTextFormat(portionFormat);

    ParagraphFormat paragraphFormat = new ParagraphFormat();
    paragraphFormat.setAlignment(TextAlignment.Right);
    paragraphFormat.setMarginRight(20);
    table.getRows().get_Item(0).setTextFormat(paragraphFormat);

    TextFrameFormat textFrameFormat = new TextFrameFormat();
    textFrameFormat.setTextVerticalType(TextVerticalType.Vertical);
    table.getRows().get_Item(1).setTextFormat(textFrameFormat);

    presentation.save("row_formatting.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Atur Pemformatan Teks pada Tingkat Kolom Tabel

Terapkan pemformatan teks pada seluruh kolom untuk menjaga konsistensi sel-selnya. Anda dapat mengatur properti font, pemformatan paragraf, dan arah teks tanpa memformat setiap sel secara terpisah.

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

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

import com.aspose.slides.*;

Presentation presentation = new Presentation("table.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

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

    PortionFormat portionFormat = new PortionFormat();
    portionFormat.setFontHeight(25);
    table.getColumns().get_Item(0).setTextFormat(portionFormat);

    ParagraphFormat paragraphFormat = new ParagraphFormat();
    paragraphFormat.setAlignment(TextAlignment.Right);
    paragraphFormat.setMarginRight(20);
    table.getColumns().get_Item(0).setTextFormat(paragraphFormat);

    TextFrameFormat textFrameFormat = new TextFrameFormat();
    textFrameFormat.setTextVerticalType(TextVerticalType.Vertical);
    table.getColumns().get_Item(1).setTextFormat(textFrameFormat);

    presentation.save("column_formatting.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Dapatkan Properti Gaya Tabel

Gunakan metode getStylePreset untuk mengambil preset yang diterapkan pada tabel dan menggunakannya kembali pada tabel lain. Ini mengidentifikasi preset daripada penimpaan format sel individu.

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

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = new double[] { 100, 150 };
    double[] rowHeights = new double[] { 5, 5, 5 };
    ITable table = slide.getShapes().addTable(10, 10, columnWidths, rowHeights);
    table.setStylePreset(TableStylePreset.DarkStyle1);

    int stylePreset = table.getStylePreset();
    System.out.println(stylePreset);

    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 isi, border, dan warna teks di atas tema tersebut.

Apakah saya dapat menyortir baris tabel seperti di Excel?

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

Apakah saya dapat memiliki kolom berbanding (bergaris) sambil mempertahankan warna khusus pada sel tertentu?

Ya. Aktifkan kolom berbanding, kemudian timpa sel tertentu dengan pemformatan lokal; pemformatan tingkat sel memiliki prioritas lebih tinggi daripada gaya tabel.