Kelola Tabel Presentasi dalam PHP

Pendahuluan

Tabel dalam PowerPoint adalah cara yang efisien untuk menampilkan dan menggambarkan informasi. Informasi dalam kisi sel (disusun dalam baris dan kolom) bersifat langsung dan mudah dipahami.

Aspose.Slides menyediakan kelas Table kelas Cell , dan tipe lainnya untuk memungkinkan Anda membuat, memperbarui, dan mengelola tabel dalam semua jenis presentasi.

Buat Tabel dari Awal

Buat sebuah instance dari kelas Presentation .
Dapatkan referensi slide melalui indeksnya.
Definisikan sebuah array columnWidth.
Definisikan sebuah array rowHeight.
Tambahkan objek Table ke slide melalui metode addTable .
Iterasikan setiap Cell untuk menerapkan pemformatan pada batas atas, bawah, kanan, dan kiri.
Gabungkan dua sel pertama pada baris pertama tabel.
Akses TextFrame milik sebuah Cell .
Tambahkan teks ke TextFrame .
Simpan presentasi yang telah dimodifikasi.

Kode PHP ini menunjukkan cara membuat tabel dalam sebuah presentasi:

  # Membuat instance kelas Presentation yang mewakili file PPTX
  $pres = new Presentation();
  try {
    # Mengakses slide pertama
    $sld = $pres->getSlides()->get_Item(0);
    # Mendefinisikan kolom dengan lebar dan baris dengan tinggi
    $dblCols = array(50, 50, 50 );
    $dblRows = array(50, 30, 30, 30, 30 );
    # Menambahkan shape tabel ke slide
    $tbl = $sld->getShapes()->addTable(100, 50, $dblCols, $dblRows);
    # Mengatur format border untuk setiap sel
    for($row = 0; $row < java_values($tbl->getRows()->size()) ; $row++) {
      for($cell = 0; $cell < java_values($tbl->getRows()->get_Item($row)->size()) ; $cell++) {
        $cellFormat = $tbl->getRows()->get_Item($row)->get_Item($cell)->getCellFormat();
        $cellFormat::getBorderTop()->getFillFormat()->setFillType(FillType::Solid);
        $cellFormat::getBorderTop()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cellFormat::getBorderTop()->setWidth(5);
        $cellFormat::getBorderBottom()->getFillFormat()->setFillType(FillType::Solid);
        $cellFormat::getBorderBottom()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cellFormat::getBorderBottom()->setWidth(5);
        $cellFormat::getBorderLeft()->getFillFormat()->setFillType(FillType::Solid);
        $cellFormat::getBorderLeft()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cellFormat::getBorderLeft()->setWidth(5);
        $cellFormat::getBorderRight()->getFillFormat()->setFillType(FillType::Solid);
        $cellFormat::getBorderRight()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cellFormat::getBorderRight()->setWidth(5);
      }
    }
    # Menggabungkan sel 1 & 2 pada baris 1
    $tbl->mergeCells($tbl->getRows()->get_Item(0)->get_Item(0), $tbl->getRows()->get_Item(1)->get_Item(1), false);
    # Menambahkan teks ke sel yang digabungkan
    $tbl->getRows()->get_Item(0)->get_Item(0)->getTextFrame()->setText("Merged Cells");
    # Menyimpan presentasi ke Disk
    $pres->save("table.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Penomoran dalam Tabel Standar

Dalam tabel standar, penomoran sel bersifat langsung dan berbasiskan nol. Sel pertama dalam tabel diindeks sebagai 0,0 (kolom 0, baris 0).

Sebagai contoh, sel-sel dalam tabel dengan 4 kolom dan 4 baris dinomori sebagai berikut:

(0, 0)	(1, 0)	(2, 0)	(3, 0)
(0, 1)	(1, 1)	(2, 1)	(3, 1)
(0, 2)	(1, 2)	(2, 2)	(3, 2)
(0, 3)	(1, 3)	(2, 3)	(3, 3)

Kode PHP ini menunjukkan cara menentukan penomoran untuk sel dalam sebuah tabel:

  # Membuat instance kelas Presentation yang mewakili file PPTX
  $pres = new Presentation();
  try {
    # Mengakses slide pertama
    $sld = $pres->getSlides()->get_Item(0);
    # Mendefinisikan kolom dengan lebar dan baris dengan tinggi
    $dblCols = array(70, 70, 70, 70 );
    $dblRows = array(70, 70, 70, 70 );
    # Menambahkan shape tabel ke slide
    $tbl = $sld->getShapes()->addTable(100, 50, $dblCols, $dblRows);
    # Mengatur format border untuk setiap sel
    foreach($tbl->getRows() as $row) {
      foreach($row as $cell) {
        $cell->getCellFormat()->getBorderTop()->getFillFormat()->setFillType(FillType::Solid);
        $cell->getCellFormat()->getBorderTop()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cell->getCellFormat()->getBorderTop()->setWidth(5);
        $cell->getCellFormat()->getBorderBottom()->getFillFormat()->setFillType(FillType::Solid);
        $cell->getCellFormat()->getBorderBottom()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cell->getCellFormat()->getBorderBottom()->setWidth(5);
        $cell->getCellFormat()->getBorderLeft()->getFillFormat()->setFillType(FillType::Solid);
        $cell->getCellFormat()->getBorderLeft()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cell->getCellFormat()->getBorderLeft()->setWidth(5);
        $cell->getCellFormat()->getBorderRight()->getFillFormat()->setFillType(FillType::Solid);
        $cell->getCellFormat()->getBorderRight()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
        $cell->getCellFormat()->getBorderRight()->setWidth(5);
      }
    }
    # Menyimpan presentasi ke disk
    $pres->save("StandardTables_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Akses Tabel yang Ada

Buat sebuah instance dari kelas Presentation .
Dapatkan referensi ke slide yang berisi tabel melalui indeksnya.
Buat objek Table dan setel menjadi null.
Iterasikan semua objek Shape sampai tabel ditemukan.

Jika Anda menduga slide yang Anda tangani hanya berisi satu tabel, Anda dapat memeriksa semua shape yang ada. Ketika sebuah shape diidentifikasi sebagai tabel, Anda dapat melakukan typecast menjadi objek Table . Namun jika slide tersebut berisi beberapa tabel, lebih baik mencari tabel yang Anda perlukan melalui metode setAlternativeText(String value) .
Gunakan objek Table untuk bekerja dengan tabel. Pada contoh di bawah, kami menambahkan baris baru ke tabel.
Simpan presentasi yang telah dimodifikasi.

Kode PHP ini menunjukkan cara mengakses dan bekerja dengan tabel yang ada:

  # Membuat instance kelas Presentation yang mewakili file PPTX
  $pres = new Presentation("UpdateExistingTable.pptx");
  try {
    # Mengakses slide pertama
    $sld = $pres->getSlides()->get_Item(0);
    # Menginisialisasi TableEx null
    $tbl = null;
    # Mengiterasi shape dan menetapkan referensi ke tabel yang ditemukan
    foreach($sld->getShapes() as $shp) {
      if (java_instanceof($shp, new JavaClass("com.aspose.slides.Table"))) {
        $tbl = $shp;
        # Menetapkan teks untuk kolom pertama pada baris kedua
        $tbl->get_Item(0, 1)->getTextFrame()->setText("New");
      }
    }
    # Menyimpan presentasi yang telah dimodifikasi ke disk
    $pres->save("table1_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Ratakan Teks dalam Tabel

Buat sebuah instance dari kelas Presentation .
Dapatkan referensi slide melalui indeksnya.
Tambahkan objek Table ke slide.
Akses objek TextFrame dari tabel.
Akses Paragraph .
Ratakan teks secara vertikal.
Simpan presentasi yang telah dimodifikasi.

Kode PHP ini menunjukkan cara meratakan teks dalam tabel:

  # Membuat instance kelas Presentation
  $pres = new Presentation();
  try {
    # Mendapatkan slide pertama
    $slide = $pres->getSlides()->get_Item(0);
    # Mendefinisikan kolom dengan lebar dan baris dengan tinggi
    $dblCols = array(120, 120, 120, 120 );
    $dblRows = array(100, 100, 100, 100 );
    # Menambahkan shape tabel ke slide
    $tbl = $slide->getShapes()->addTable(100, 50, $dblCols, $dblRows);
    $tbl->get_Item(1, 0)->getTextFrame()->setText("10");
    $tbl->get_Item(2, 0)->getTextFrame()->setText("20");
    $tbl->get_Item(3, 0)->getTextFrame()->setText("30");
    # Mengakses text frame
    $txtFrame = $tbl->get_Item(0, 0)->getTextFrame();
    # Membuat objek Paragraph untuk text frame
    $paragraph = $txtFrame->getParagraphs()->get_Item(0);
    # Membuat objek Portion untuk paragraph
    $portion = $paragraph->getPortions()->get_Item(0);
    $portion->setText("Text here");
    $portion->getPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
    $portion->getPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
    # Menyelaraskan teks secara vertikal
    $cell = $tbl->get_Item(0, 0);
    $cell->setTextAnchorType(TextAnchorType::Center);
    $cell->setTextVerticalType(TextVerticalType::Vertical270);
    # Menyimpan presentasi ke disk
    $pres->save("Vertical_Align_Text_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Setel Pemformatan Teks pada Tingkat Tabel

Buat sebuah instance dari kelas Presentation .
Dapatkan referensi slide melalui indeksnya.
Akses objek Table dari Slide.
Setel setFontHeight(float value) untuk teks.
Setel setAlignment(int value) dan setMarginRight(float value) .
Setel setTextVerticalType(byte value) .
Simpan presentasi yang telah dimodifikasi.

Kode PHP ini menunjukkan cara menerapkan opsi pemformatan pilihan Anda pada teks dalam tabel:

  # Membuat instance kelas Presentation
  $pres = new Presentation("simpletable.pptx");
  try {
    # Asumsikan bahwa shape pertama pada slide pertama adalah tabel
    $someTable = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0);
    # Mengatur tinggi font sel tabel
    $portionFormat = new PortionFormat();
    $portionFormat::setFontHeight(25);
    $someTable->setTextFormat($portionFormat);
    # Mengatur perataan teks sel tabel dan margin kanan dalam satu panggilan
    $paragraphFormat = new ParagraphFormat();
    $paragraphFormat::setAlignment(TextAlignment->Right);
    $paragraphFormat::setMarginRight(20);
    $someTable->setTextFormat($paragraphFormat);
    # Mengatur tipe vertikal teks sel tabel
    $textFrameFormat = new TextFrameFormat();
    $textFrameFormat::setTextVerticalType(TextVerticalType::Vertical);
    $someTable->setTextFormat($textFrameFormat);
    $pres->save("result.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Dapatkan Properti Gaya Tabel

Aspose.Slides memungkinkan Anda mengambil properti gaya untuk sebuah tabel sehingga Anda dapat menggunakan detail tersebut pada tabel lain atau di tempat lain. Kode PHP ini menunjukkan cara mendapatkan properti gaya dari gaya preset tabel:

  $pres = new Presentation();
  try {
    $table = $pres->getSlides()->get_Item(0)->getShapes()->addTable(10, 10, array(100, 150 ), array(5, 5, 5 ));
    $table->setStylePreset(TableStylePreset->DarkStyle1);// ubah tema preset gaya default

    $pres->save("table.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Kunci Rasio Aspek Tabel

Rasio aspek sebuah bentuk geometris adalah perbandingan ukuran dalam dimensi yang berbeda. Aspose.Slides menyediakan metode setAspectRatioLocked untuk memungkinkan Anda mengunci pengaturan rasio aspek pada tabel dan bentuk lainnya.

Kode PHP ini menunjukkan cara mengunci rasio aspek untuk tabel:

  $pres = new Presentation("pres.pptx");
  try {
    $table = $pres->getSlides()->get_Item(0)->getShapes()->get_Item(0);
    echo("Lock aspect ratio set: " . $table->getGraphicalObjectLock()->getAspectRatioLocked());
    $table->getGraphicalObjectLock()->setAspectRatioLocked(!$table->getGraphicalObjectLock()->getAspectRatioLocked());// invert

    echo("Lock aspect ratio set: " . $table->getGraphicalObjectLock()->getAspectRatioLocked());
    $pres->save("pres-out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

Apakah saya dapat mengaktifkan arah baca kanan-ke-kiri (RTL) untuk seluruh tabel dan teks di sel‑nya?

Ya. Tabel menyediakan metode setRightToLeft , dan paragraf memiliki ParagraphFormat::setRightToLeft . Menggunakan keduanya memastikan urutan RTL yang tepat dan perenderan di dalam sel.

Bagaimana saya dapat mencegah pengguna memindahkan atau mengubah ukuran tabel dalam file akhir?

Gunakan kunci shape untuk menonaktifkan pemindahan, pengubahan ukuran, pemilihan, dll. Kunci ini juga berlaku pada tabel.

Apakah memasukkan gambar di dalam sel sebagai latar belakang didukung?

Ya. Anda dapat mengatur picture fill untuk sebuah sel; gambar akan menutupi area sel sesuai mode yang dipilih (stretch atau tile).

Kelola Baris dan Kolom dalam Tabel PowerPoint Menggunakan PHP