Manage TextBox
Texts on slides typically exist in text boxes or shapes. Therefore, to add a text to a slide, you have to add a text box and then put some text inside the textbox. Aspose.Slides for PHP via Java provides the IAutoShape interface that allows you to add a shape containing some text.
Info
Aspose.Slides also provides the IShape interface that allows you to add shapes to slides. However, not all shapes added through theIShape
interface can hold text. But shapes added through the IAutoShape interface may contain text.
Note
Therefore, when dealing with a shape to which you want to add text, you may want to check and confirm that it was cast through theIAutoShape
interface. Only then will you be able to work with TextFrame, which is a property under IAutoShape
. See the Update Text section on this page.
Create Text Box on Slide
To create a textbox on a slide, go through these steps:
- Create an instance of the Presentation class.
- Obtain a reference for the first slide in the newly created presentation.
- Add an IAutoShape object with ShapeType set as
Rectangle
at a specified position on the slide and obtain the reference for the newly addedIAutoShape
object. - Add a
TextFrame
property to theIAutoShape
object that will contain a text. In the example below, we added this text: Aspose TextBox - Finally, write the PPTX file through the
Presentation
object.
This PHP code—an implementation of the steps above—shows you how to add text to a slide:
# Instantiates Presentation
$pres = new Presentation();
try {
# Gets the first slide in the presentation
$sld = $pres->getSlides()->get_Item(0);
# Adds an AutoShape with type set as Rectangle
$ashp = $sld->getShapes()->addAutoShape(ShapeType::Rectangle, 150, 75, 150, 50);
# Adds TextFrame to the Rectangle
$ashp->addTextFrame(" ");
# Accesses the text frame
$txtFrame = $ashp->getTextFrame();
# Creates the Paragraph object for text frame
$para = $txtFrame->getParagraphs()->get_Item(0);
# Creates a Portion object for paragraph
$portion = $para->getPortions()->get_Item(0);
# Sets Text
$portion->setText("Aspose TextBox");
# Saves the presentation to disk
$pres->save("TextBox_out.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Check for Text Box Shape
Aspose.Slides provides the isTextBox() property (from the AutoShape class) to allow you to examine shapes and find text boxes.
This PHP code shows you how to check whether a shape was created as a text box:
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 text box" : "shape is text not box");
}
}
$pres = new Presentation("pres.pptx");
try {
$forEachShapeCallback = java_closure(new ShapeCallback(), null, java("com.aspose.slides.ForEachSlideCallback"));
ForEach::shape($pres, $forEachShapeCallback);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Add Column In Text Box
Aspose.Slides provides the ColumnCount and ColumnSpacing properties (from the ITextFrameFormat interface and TextFrameFormat class) that allow you to add columns to textboxes. You get to specify the number of columns in a text box and set the amount spacing in points between columns.
This code demonstrates the described operation:
$pres = new Presentation();
try {
# Gets the first slide in the presentation
$slide = $pres->getSlides()->get_Item(0);
# Add an AutoShape with type set as Rectangle
$aShape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 300, 300);
# Add TextFrame to the 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!");
# Gets the text format of TextFrame
$format = $aShape->getTextFrame()->getTextFrameFormat();
# Specifies the number of columns in TextFrame
$format->setColumnCount(3);
# Specifies the spacing between columns
$format->setColumnSpacing(10);
# Saves the presentation
$pres->save("ColumnCount.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Add Column In Text Frame
Aspose.Slides for PHP via Java provides the ColumnCount property (from the ITextFrameFormat interface) that allows you to add columns in text frames. Through this property, you can specify your preferred number of columns in a text frame.
This PHP code shows you how to add a column inside a text frame:
$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 allows you to change or update the text contained in a text box or all the texts contained in a presentation.
This PHP code demonstrates an operation where all the texts in a presentation are updated or changed:
$pres = new Presentation("text.pptx");
try {
foreach($pres->getSlides() as $slide) {
foreach($slide->getShapes() as $shape) {
# Checks if shape supports text frame (IAutoShape).
if (java_instanceof($shape, new JavaClass("com.aspose.slides.AutoShape"))) {
$autoShape = $shape;
# Iterates through paragraphs in text frame
foreach($autoShape->getTextFrame()->getParagraphs() as $paragraph) {
# Iterates through each portion in paragraph
foreach($paragraph->getPortions() as $portion) {
$portion->setText($portion->getText()->replace("years", "months"));// Changes text
$portion->getPortionFormat()->setFontBold(NullableBool::True);// Changes formatting
}
}
}
}
}
# Saves modified presentation
$pres->save("text-changed.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Add Text Box with Hyperlink
You can insert a link inside a text box. When the text box is clicked, users are directed to open the link.
To add a text box containing a link, go through these steps:
- Create an instance of the
Presentation
class. - Obtain a reference for the first slide in the newly created presentation.
- Add an
AutoShape
object withShapeType
set asRectangle
at a specified position on the slide and obtain a reference of the newly added AutoShape object. - Add a
TextFrame
to theAutoShape
object that contains Aspose TextBox as its default text. - Instantiate the
IHyperlinkManager
class. - Assign the
IHyperlinkManager
object to the HyperlinkClick property associated with your preferred portion of theTextFrame
. - Finally, write the PPTX file through the
Presentation
object.
This PHP code—an implementation of the steps above—shows you how to add a text box with a hyperlink to a slide:
# Instantiates a Presentation class that represents a PPTX
$pres = new Presentation();
try {
# Gets the first slide in the presentation
$slide = $pres->getSlides()->get_Item(0);
# Adds an AutoShape object with type set as Rectangle
$shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 150, 150, 150, 50);
# Casts the shape to AutoShape
$pptxAutoShape = $shape;
# Accesses the ITextFrame property associated with the AutoShape
$pptxAutoShape->addTextFrame("");
$textFrame = $pptxAutoShape->getTextFrame();
# Adds some text to the frame
$textFrame->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->setText("Aspose.Slides");
# Sets the Hyperlink for the portion text
$hyperlinkManager = $textFrame->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat()->getHyperlinkManager();
$hyperlinkManager->setExternalHyperlinkClick("http://www.aspose.com");
# Saves the PPTX Presentation
$pres->save("hLink_out.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}