Mengelola Kotak Teks dalam Presentasi Menggunakan PHP

Pendahuluan

Teks pada slide biasanya berada dalam kotak teks atau bentuk. Oleh karena itu, untuk menambahkan teks ke sebuah slide, Anda harus menambahkan kotak teks dan kemudian menaruh beberapa teks di dalam kotak teks tersebut. Aspose.Slides untuk PHP via Java menyediakan kelas AutoShape yang memungkinkan Anda menambahkan bentuk yang berisi beberapa teks.

Info

Aspose.Slides juga menyediakan kelas Shape yang memungkinkan Anda menambahkan bentuk ke slide. Namun, tidak semua bentuk yang ditambahkan melalui kelas Shape dapat menampung teks. Tetapi bentuk yang ditambahkan melalui kelas AutoShape dapat berisi teks.

Note

Oleh karena itu, ketika menangani sebuah bentuk yang ingin Anda tambahkan teks, Anda mungkin ingin memeriksa dan memastikan bahwa bentuk tersebut di‑cast melalui kelas AutoShape. Hanya dengan begitu Anda dapat menggunakan TextFrame, yang merupakan properti di bawah AutoShape. Lihat bagian Update Text pada halaman ini.

Buat Kotak Teks pada Slide

Untuk membuat kotak teks pada slide, ikuti langkah-langkah berikut:

Buat instansi dari kelas Presentation.
Dapatkan referensi untuk slide pertama dalam presentasi yang baru dibuat.
Tambahkan objek AutoShape dengan tipe bentuk diatur sebagai Rectangle pada posisi tertentu di slide dan dapatkan referensi untuk objek AutoShape yang baru ditambahkan.
Tambahkan TextFrame ke objek AutoShape yang akan berisi teks. Pada contoh di bawah, kami menambahkan teks berikut: Aspose TextBox
Akhirnya, tulis file PPTX melalui objek Presentation.

Kode PHP ini—implementasi dari langkah-langkah di atas—menunjukkan cara menambahkan teks ke sebuah slide:

  # Membuat instansi Presentation
  $pres = new Presentation();
  try {
    # Mendapatkan slide pertama dalam presentasi
    $sld = $pres->getSlides()->get_Item(0);
    # Menambah AutoShape dengan tipe diatur sebagai Rectangle
    $ashp = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 150, 75, 150, 50);
    # Menambah TextFrame ke Rectangle
    $ashp->addTextFrame(" ");
    # Mengakses frame teks
    $txtFrame = $ashp->getTextFrame();
    # Membuat objek Paragraph untuk frame teks
    $para = $txtFrame->getParagraphs()->get_Item(0);
    # Membuat objek Portion untuk paragraf
    $portion = $para->getPortions()->get_Item(0);
    # Mengatur Teks
    $portion->setText("Aspose TextBox");
    # Menyimpan presentasi ke disk
    $pres->save("TextBox_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Periksa Bentuk Kotak Teks

Aspose.Slides menyediakan metode isTextBox dari kelas AutoShape, yang memungkinkan Anda memeriksa bentuk dan mengidentifikasi kotak teks.

Text box and shape

Kode PHP ini menunjukkan cara memeriksa apakah sebuah bentuk dibuat sebagai kotak teks:

class ShapeCallback {
    function invoke($shape, $slide, $index) {
        if (java_instanceof($shape, new JavaClass("com.aspose.slides.AutoShape"))) {
            $autoShape = $shape;
            echo(java_is_true($autoShape->isTextBox()) ? "shape is a text box" : "shape is not a text box");
        }
    }
}

$presentation = new Presentation("sample.pptx");
try {
    $forEachShapeCallback = java_closure(new ShapeCallback(), null, java("com.aspose.slides.ForEachSlideCallback"));
    ForEach::shape($presentation, $forEachShapeCallback);
} finally {
    $presentation->dispose();
}

Perhatikan bahwa jika Anda hanya menambahkan autoshape menggunakan metode addAutoShape dari kelas ShapeCollection, metode isTextBox pada autoshape akan mengembalikan false. Namun, setelah Anda menambahkan teks ke autoshape menggunakan metode addTextFrame atau metode setText, properti isTextBox akan mengembalikan true.

$presentation = new Presentation();
$slide = $presentation->getSlides()->get_Item(0);

$shape1 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 10, 100, 40);
// shape1->isTextBox() mengembalikan false
$shape1->addTextFrame("shape 1");
// shape1->isTextBox() mengembalikan true

$shape2 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 110, 100, 40);
// shape2->isTextBox() mengembalikan false
$shape2->getTextFrame()->setText("shape 2");
// shape2->isTextBox() mengembalikan true

$shape3 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 210, 100, 40);
// shape3->isTextBox() mengembalikan false
$shape3->addTextFrame("");
// shape3->isTextBox() mengembalikan false

$shape4 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 310, 100, 40);
// shape4->isTextBox() mengembalikan false
$shape4->getTextFrame()->setText("");
// shape4->isTextBox() mengembalikan false

Tambahkan Kolom ke Kotak Teks

Aspose.Slides menyediakan metode setColumnCount dan setColumnSpacing dari kelas TextFrameFormat yang memungkinkan Anda menambahkan kolom ke kotak teks. Anda dapat menentukan jumlah kolom dalam kotak teks dan mengatur jarak antar kolom dalam poin.

Kode ini menunjukkan operasi yang dijelaskan:

  $pres = new Presentation();
  try {
    # Mendapatkan slide pertama dalam presentasi
    $slide = $pres->getSlides()->get_Item(0);
    # Menambahkan AutoShape dengan tipe diatur sebagai Rectangle
    $aShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 300, 300);
    # Menambahkan TextFrame ke Rectangle
    $aShape->addTextFrame("All these columns are limited to be within a single text container -- " . "you can add or delete text and the new or remaining text automatically adjusts " . "itself to flow within the container. You cannot have text flow from one container " . "to other though -- we told you PowerPoint's column options for text are limited!");
    # Mendapatkan format teks dari TextFrame
    $format = $aShape->getTextFrame()->getTextFrameFormat();
    # Menentukan jumlah kolom dalam TextFrame
    $format->setColumnCount(3);
    # Menentukan jarak antar kolom
    $format->setColumnSpacing(10);
    # Menyimpan presentasi
    $pres->save("ColumnCount.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Tambahkan Kolom ke Bingkai Teks

Aspose.Slides untuk PHP via Java menyediakan metode setColumnCount dari kelas TextFrameFormat yang memungkinkan Anda menambahkan kolom dalam bingkai teks. Melalui properti ini, Anda dapat menentukan jumlah kolom yang diinginkan dalam sebuah bingkai teks.

Kode PHP ini menunjukkan cara menambahkan kolom di dalam bingkai teks:

  $outPptxFileName = "ColumnsTest.pptx";
  $pres = new Presentation();
  try {
    $shape1 = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 300, 300);
    $format = $shape1->getTextFrame()->getTextFrameFormat();
    $format->setColumnCount(2);
    $shape1->getTextFrame()->setText("All these columns are forced to stay within a single text container -- " . "you can add or delete text - and the new or remaining text automatically adjusts " . "itself to stay within the container. You cannot have text spill over from one container " . "to other, though -- because PowerPoint's column options for text are limited!");
    $pres->save($outPptxFileName, SaveFormat::Pptx);
    $test = new Presentation($outPptxFileName);
    try {
      $autoShape = $test->getSlides()->get_Item(0)->getShapes()->get_Item(0);
      Assert->assertTrue(2 == $autoShape->getTextFrame()->getTextFrameFormat()->getColumnCount());
      Assert->assertTrue(Double->NaN == $autoShape->getTextFrame()->getTextFrameFormat()->getColumnSpacing());
    } finally {
      if (!java_is_null($test)) {
        $test->dispose();
      }
    }
    $format->setColumnSpacing(20);
    $pres->save($outPptxFileName, SaveFormat::Pptx);
    $test1 = new Presentation($outPptxFileName);
    try {
      $autoShape = $test1->getSlides()->get_Item(0)->getShapes()->get_Item(0);
      Assert->assertTrue(2 == $autoShape->getTextFrame()->getTextFrameFormat()->getColumnCount());
      Assert->assertTrue(20 == $autoShape->getTextFrame()->getTextFrameFormat()->getColumnSpacing());
    } finally {
      if (!java_is_null($test1)) {
        $test1->dispose();
      }
    }
    $format->setColumnCount(3);
    $format->setColumnSpacing(15);
    $pres->save($outPptxFileName, SaveFormat::Pptx);
    $test2 = new Presentation($outPptxFileName);
    try {
      $autoShape = $test2->getSlides()->get_Item(0)->getShapes()->get_Item(0);
      Assert->assertTrue(3 == $autoShape->getTextFrame()->getTextFrameFormat()->getColumnCount());
      Assert->assertTrue(15 == $autoShape->getTextFrame()->getTextFrameFormat()->getColumnSpacing());
    } finally {
      if (!java_is_null($test2)) {
        $test2->dispose();
      }
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Update Text

Aspose.Slides memungkinkan Anda mengubah atau memperbarui teks yang terdapat dalam kotak teks atau semua teks yang terdapat dalam sebuah presentasi.

Kode PHP ini menunjukkan operasi di mana semua teks dalam sebuah presentasi diperbarui atau diubah:

  $pres = new Presentation("text.pptx");
  try {
    foreach($pres->getSlides() as $slide) {
      foreach($slide->getShapes() as $shape) {
        # Memeriksa apakah bentuk mendukung bingkai teks (IAutoShape).
        if (java_instanceof($shape, new JavaClass("com.aspose.slides.AutoShape"))) {
          $autoShape = $shape;
          # Mengulangi paragraf dalam bingkai teks
          foreach($autoShape->getTextFrame()->getParagraphs() as $paragraph) {
            # Mengulangi setiap bagian dalam paragraf
            foreach($paragraph->getPortions() as $portion) {
              $portion->setText($portion->getText()->replace("years", "months"));// Mengubah teks

              $portion->getPortionFormat()->setFontBold(NullableBool::True);// Mengubah format

            }
          }
        }
      }
    }
    # Menyimpan presentasi yang telah diubah
    $pres->save("text-changed.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Tambahkan Kotak Teks dengan Hyperlink

Anda dapat menyisipkan tautan di dalam kotak teks. Ketika kotak teks diklik, pengguna diarahkan untuk membuka tautan tersebut.

Untuk menambahkan kotak teks yang berisi tautan, ikuti langkah-langkah berikut:

Buat instansi dari kelas Presentation.
Dapatkan referensi untuk slide pertama dalam presentasi yang baru dibuat.
Tambahkan objek AutoShape dengan ShapeType diatur sebagai Rectangle pada posisi tertentu di slide dan dapatkan referensi objek AutoShape yang baru ditambahkan.
Tambahkan TextFrame ke objek AutoShape yang berisi Aspose TextBox sebagai teks defaultnya.
Instansiasi kelas HyperlinkManager.
Tetapkan hyperlink menggunakan metode setExternalHyperlinkClick yang terkait dengan bagian yang Anda inginkan dari TextFrame.
Akhirnya, tulis file PPTX melalui objek Presentation.

Kode PHP ini—implementasi dari langkah-langkah di atas—menunjukkan cara menambahkan kotak teks dengan hyperlink ke sebuah slide:

  # Membuat instansi kelas Presentation yang mewakili sebuah PPTX
  $pres = new Presentation();
  try {
    # Mendapatkan slide pertama dalam presentasi
    $slide = $pres->getSlides()->get_Item(0);
    # Menambahkan objek AutoShape dengan tipe diatur sebagai Rectangle
    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 150, 150, 150, 50);
    # Meng-cast bentuk menjadi AutoShape
    $pptxAutoShape = $shape;
    # Mengakses properti ITextFrame yang terkait dengan AutoShape
    $pptxAutoShape->addTextFrame("");
    $textFrame = $pptxAutoShape->getTextFrame();
    # Menambahkan beberapa teks ke bingkai
    $textFrame->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->setText("Aspose.Slides");
    # Mengatur Hyperlink untuk teks bagian
    $hyperlinkManager = $textFrame->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat()->getHyperlinkManager();
    $hyperlinkManager->setExternalHyperlinkClick("http://www.aspose.com");
    # Menyimpan presentasi PPTX
    $pres->save("hLink_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

Apa perbedaan antara kotak teks dan placeholder teks saat bekerja dengan master slide?

Sebuah placeholder mewarisi gaya/posisi dari master dan dapat ditimpa pada layouts, sedangkan kotak teks biasa adalah objek independen pada slide tertentu dan tidak berubah saat Anda beralih layout.

Bagaimana saya dapat melakukan penggantian teks secara massal di seluruh presentasi tanpa menyentuh teks di dalam chart, tabel, dan SmartArt?

Batasi iterasi Anda hanya pada auto‑shape yang memiliki bingkai teks dan kecualikan objek tersemat (chart, table, SmartArt) dengan menelusuri koleksi mereka secara terpisah atau melewati tipe objek tersebut.

Kelola Placeholder Presentasi di PHP Tingkatkan Presentasi Anda dengan AutoFit di PHP