Διαχείριση Πλαισίων Κειμένου σε Παρουσιάσεις με PHP

Εισαγωγή

Τα κείμενα στις διαφάνειες συνήθως βρίσκονται σε πλαίσια κειμένου ή σχήματα. Επομένως, για να προσθέσετε κείμενο σε μια διαφάνεια, πρέπει να προσθέσετε ένα πλαίσιο κειμένου και στη συνέχεια να βάλετε κάποιο κείμενο μέσα στο πλαίσιο. Το Aspose.Slides for PHP μέσω Java παρέχει την κλάση AutoShape που σας επιτρέπει να προσθέσετε σχήμα που περιέχει κάποιο κείμενο.

Info

Το Aspose.Slides παρέχει επίσης την κλάση Shape που επιτρέπει την προσθήκη σχημάτων σε διαφάνειες. Ωστόσο, δεν όλα τα σχήματα που προστίθενται μέσω της κλάσης Shape μπορούν να περιέχουν κείμενο. Αλλά τα σχήματα που προστίθενται μέσω της κλάσης AutoShape μπορεί να περιέχουν κείμενο.

Note

Επομένως, όταν εργάζεστε με ένα σχήμα στο οποίο θέλετε να προσθέσετε κείμενο, ίσως θελήσετε να ελέγξετε και να επιβεβαιώσετε ότι έχει μετατραπεί μέσω της κλάσης AutoShape. Μόνο τότε θα μπορέσετε να εργαστείτε με το TextFrame, το οποίο είναι ιδιότητα της AutoShape. Δείτε την ενότητα Ενημέρωση κειμένου σε αυτή τη σελίδα.

Δημιουργία Πλαισίου Κειμένου σε Διαφάνεια

Για να δημιουργήσετε ένα πλαίσιο κειμένου σε μια διαφάνεια, ακολουθήστε τα παρακάτω βήματα:

Δημιουργήστε ένα αντικείμενο της κλάσης Presentation.
Αποκτήστε μια αναφορά για την πρώτη διαφάνεια στην πρόσφατα δημιουργημένη παρουσίαση.
Προσθέστε ένα αντικείμενο AutoShape με τύπο σχήματος ορισμένο σε Rectangle σε καθορισμένη θέση στη διαφάνεια και αποκτήστε την αναφορά για το νεοδημιουργημένο αντικείμενο AutoShape.
Προσθέστε ένα TextFrame στο αντικείμενο AutoShape που θα περιέχει κείμενο. Στο παρακάτω παράδειγμα, προσθέσαμε αυτό το κείμενο: Aspose TextBox
Τέλος, γράψτε το αρχείο PPTX μέσω του αντικειμένου Presentation.

Αυτός ο κώδικας PHP—μια υλοποίηση των παραπάνω βημάτων—σας δείχνει πώς να προσθέσετε κείμενο σε μια διαφάνεια:

  # Δημιουργεί παρουσίαση
  $pres = new Presentation();
  try {
    # Λαμβάνει τη πρώτη διαφάνεια στην παρουσίαση
    $sld = $pres->getSlides()->get_Item(0);
    # Προσθέτει AutoShape με τύπο ορισμένο ως Rectangle
    $ashp = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 150, 75, 150, 50);
    # Προσθέτει TextFrame στο Rectangle
    $ashp->addTextFrame(" ");
    # Αποκτά πρόσβαση στο πλαίσιο κειμένου
    $txtFrame = $ashp->getTextFrame();
    # Δημιουργεί το αντικείμενο Paragraph για το πλαίσιο κειμένου
    $para = $txtFrame->getParagraphs()->get_Item(0);
    # Δημιουργεί ένα αντικείμενο Portion για το παράγραφο
    $portion = $para->getPortions()->get_Item(0);
    # Ορίζει κείμενο
    $portion->setText("Aspose TextBox");
    # Αποθηκεύει την παρουσίαση στο δίσκο
    $pres->save("TextBox_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Έλεγχος για Σχήμα Πλαισίου Κειμένου

Το Aspose.Slides παρέχει τη μέθοδο isTextBox από την κλάση AutoShape που σας επιτρέπει να εξετάσετε σχήματα και να εντοπίσετε πλαίσια κειμένου.

Πλαίσιο κειμένου και σχήμα

Αυτός ο κώδικας PHP σας δείχνει πώς να ελέγξετε εάν ένα σχήμα δημιουργήθηκε ως πλαίσιο κειμένου:

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();
}

Σημειώστε ότι εάν απλώς προσθέσετε ένα autoshape χρησιμοποιώντας τη μέθοδο addAutoShape από την κλάση ShapeCollection, η μέθοδος isTextBox του autoshape θα επιστρέψει false. Ωστόσο, αφού προσθέσετε κείμενο στο autoshape χρησιμοποιώντας τη μέθοδο addTextFrame ή τη μέθοδο setText, η ιδιότητα isTextBox θα επιστρέψει true.

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

$shape1 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 10, 100, 40);
// shape1->isTextBox() επιστρέφει false
$shape1->addTextFrame("shape 1");
// shape1->isTextBox() επιστρέφει true

$shape2 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 110, 100, 40);
// shape2->isTextBox() επιστρέφει false
$shape2->getTextFrame()->setText("shape 2");
// shape2->isTextBox() επιστρέφει true

$shape3 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 210, 100, 40);
// shape3->isTextBox() επιστρέφει false
$shape3->addTextFrame("");
// shape3->isTextBox() επιστρέφει false

$shape4 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 310, 100, 40);
// shape4->isTextBox() επιστρέφει false
$shape4->getTextFrame()->setText("");
// shape4->isTextBox() επιστρέφει false

Προσθήκη Στηλών σε Πλαίσιο Κειμένου

Το Aspose.Slides παρέχει τις μεθόδους setColumnCount και setColumnSpacing από την κλάση TextFrameFormat που σας επιτρέπουν να προσθέσετε στήλες σε πλαίσια κειμένου. Μπορείτε να καθορίσετε τον αριθμό των στηλών σε ένα πλαίσιο κειμένου και το διάστημα μεταξύ των στηλών σε πόντους.

Αυτός ο κώδικας επιδεικνύει τη περιγραφόμενη λειτουργία:

  $pres = new Presentation();
  try {
    # Λαμβάνει τη πρώτη διαφάνεια στην παρουσίαση
    $slide = $pres->getSlides()->get_Item(0);
    # Προσθέτει AutoShape με τύπο ορισμένο ως Rectangle
    $aShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 300, 300);
    # Προσθέτει TextFrame στο 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!");
    # Λαμβάνει τη μορφοποίηση κειμένου του TextFrame
    $format = $aShape->getTextFrame()->getTextFrameFormat();
    # Καθορίζει τον αριθμό των στηλών στο TextFrame
    $format->setColumnCount(3);
    # Καθορίζει το διάστημα μεταξύ των στηλών
    $format->setColumnSpacing(10);
    # Αποθηκεύει την παρουσίαση
    $pres->save("ColumnCount.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Προσθήκη Στηλών σε Πλαίσιο Κειμένου

Το Aspose.Slides for PHP μέσω Java παρέχει τη μέθοδο setColumnCount από την κλάση TextFrameFormat που επιτρέπει την προσθήκη στηλών σε πλαίσια κειμένου. Μέσω αυτής της ιδιότητας, μπορείτε να καθορίσετε τον προτιμώμενο αριθμό στηλών σε ένα πλαίσιο κειμένου.

Αυτός ο κώδικας PHP σας δείχνει πώς να προσθέσετε μια στήλη μέσα σε ένα πλαίσιο κειμένου:

  $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();
    }
  }

Ενημέρωση Κειμένου

Το Aspose.Slides σας επιτρέπει να αλλάξετε ή να ενημερώσετε το κείμενο που περιέχεται σε ένα πλαίσιο κειμένου ή όλο το κείμενο που περιέχεται σε μια παρουσίαση.

Αυτός ο κώδικας PHP επιδεικνύει μια λειτουργία όπου όλα τα κείμενα σε μια παρουσίαση ενημερώνονται ή τροποποιούνται:

  $pres = new Presentation("text.pptx");
  try {
    foreach($pres->getSlides() as $slide) {
      foreach($slide->getShapes() as $shape) {
        # Ελέγχει εάν το σχήμα υποστηρίζει πλαίσιο κειμένου (IAutoShape).
        if (java_instanceof($shape, new JavaClass("com.aspose.slides.AutoShape"))) {
          $autoShape = $shape;
          # Διατρέχει τις παραγράφους στο πλαίσιο κειμένου
          foreach($autoShape->getTextFrame()->getParagraphs() as $paragraph) {
            # Διατρέχει κάθε τμήμα στην παράγραφο
            foreach($paragraph->getPortions() as $portion) {
              $portion->setText($portion->getText()->replace("years", "months"));// Αλλάζει το κείμενο

              $portion->getPortionFormat()->setFontBold(NullableBool::True);// Αλλάζει τη μορφοποίηση

            }
          }
        }
      }
    }
    # Αποθηκεύει την τροποποιημένη παρουσίαση
    $pres->save("text-changed.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Προσθήκη Πλαισίου Κειμένου με Υπερσύνδεσμο

Μπορείτε να εισάγετε έναν σύνδεσμο μέσα σε ένα πλαίσιο κειμένου. Όταν το πλαίσιο κειμένου κάνει κλικ, οι χρήστες μεταφέρονται για να ανοίξουν τον σύνδεσμο.

Για να προσθέσετε ένα πλαίσιο κειμένου που περιέχει σύνδεσμο, ακολουθήστε τα παρακάτω βήματα:

Δημιουργήστε ένα αντικείμενο της κλάσης Presentation.
Αποκτήστε μια αναφορά για την πρώτη διαφάνεια στην πρόσφατα δημιουργημένη παρουσίαση.
Προσθέστε ένα αντικείμενο AutoShape με ShapeType ορισμένο ως Rectangle σε καθορισμένη θέση στη διαφάνεια και αποκτήστε την αναφορά του νεοδημιουργημένου αντικειμένου AutoShape.
Προσθέστε ένα TextFrame στο αντικείμενο AutoShape που περιέχει Aspose TextBox ως προεπιλεγμένο κείμενο.
Δημιουργήστε ένα αντικείμενο της κλάσης HyperlinkManager.
Εκχωρήστε έναν υπερσύνδεσμο χρησιμοποιώντας τη μέθοδο setExternalHyperlinkClick που συνδέεται με το επιθυμητό τμήμα του TextFrame.
Τέλος, γράψτε το αρχείο PPTX μέσω του αντικειμένου Presentation.

Αυτός ο κώδικας PHP—μια υλοποίηση των παραπάνω βημάτων—σας δείχνει πώς να προσθέσετε ένα πλαίσιο κειμένου με υπερσύνδεσμο σε μια διαφάνεια:

  # Δημιουργεί ένα αντικείμενο Presentation που αντιπροσωπεύει ένα PPTX
  $pres = new Presentation();
  try {
    # Λαμβάνει την πρώτη διαφάνεια στην παρουσίαση
    $slide = $pres->getSlides()->get_Item(0);
    # Προσθέτει ένα αντικείμενο AutoShape με τύπο ορισμένο ως Rectangle
    $shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 150, 150, 150, 50);
    # Μετατρέπει το σχήμα σε AutoShape
    $pptxAutoShape = $shape;
    # Πρόσβαση στην ιδιότητα ITextFrame που συσχετίζεται με το AutoShape
    $pptxAutoShape->addTextFrame("");
    $textFrame = $pptxAutoShape->getTextFrame();
    # Προσθέτει κάποιο κείμενο στο πλαίσιο
    $textFrame->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->setText("Aspose.Slides");
    # Ορίζει τον υπερσύνδεσμο για το κείμενο του τμήματος
    $hyperlinkManager = $textFrame->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat()->getHyperlinkManager();
    $hyperlinkManager->setExternalHyperlinkClick("http://www.aspose.com");
    # Αποθηκεύει την παρουσίαση PPTX
    $pres->save("hLink_out.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Συχνές Ερωτήσεις

What’s the difference between a text box and a text placeholder when working with master slides?

A placeholder inherits style/position from the master and can be overridden on layouts, whereas a regular text box is an independent object on a specific slide and doesn’t change when you switch layouts.

How can I perform a bulk text replacement across the presentation without touching text inside charts, tables, and SmartArt?

Limit your iteration to auto-shapes that have text frames and exclude embedded objects (charts, tables, SmartArt) by traversing their collections separately or skipping those object types.

Διαχείριση Placeholder Παρουσιάσεων σε PHP Βελτιώστε τις παρουσιάσεις σας με AutoFit σε PHP