add

R2026b

Class: mlreportgen.ppt.TextBoxPlaceholder
Namespace: mlreportgen.ppt

Add content to text box placeholder

expand all in page

Syntax

addedParagraphObj = add(textBoxPlaceholder,paragraph)

Description

addedParagraphObj = add(textBoxPlaceholder,paragraph) adds text as a paragraph in the specified text box placeholder and returns the paragraph object.

example

Examples

expand all

To add a paragraph to a slide title, use the add method of the TextBoxPlaceholder object that represents the title. This example creates a presentation with a Title and Table slide and then creates a second presentation from the first presentation. In the second presentation, the example adds content to the title of the Title and Table slide.

Import the PPT namespace so that you do not have to use long, fully qualified names for the PPT API classes.

import mlreportgen.ppt.*

Create a presentation and add a Title and Table slide to the presentation.

ppt = Presentation("myPPT1.pptx");
open(ppt);
slide = add(ppt,"Title and Table");

Find the text box placeholder for the title and replace the content.

contents = find(slide,"Title");
replace(contents(1),"Hello World");

Close and generate the presentation.

close(ppt);

Here is the title slide in the generated presentation:

Slide with a single line of text reading “Hello World” positioned near the upper left, with the date and slide number in the lower corners.

Create a second presentation, using the first presentation as the template.

ppt = Presentation("myPPT2.pptx","myPPT1.pptx");
open(ppt);

Find the text box placeholder for the title and add content to the title.

contents = find(ppt,"Title");
add(contents(1)," -- How are You?");

Close and view the presentation.

close(ppt);
rptview(ppt)

In the second presentation, the title has the content from the template presentation and the added content.

Slide showing two lines of text near the upper left: “Hello World” and a second indented line reading “-- How are You?”, with the date and slide number in the lower corners.

Input Arguments

expand all

Text box placeholder, specified as an mlreportgen.ppt.TextBoxPlaceholder object.

Paragraph to add to the text box placeholder, specified as a character vector, string scalar, or mlreportgen.ppt.Paragraph object.

Output Arguments

expand all

Added paragraph, returned as an mlreportgen.ppt.Paragraph object.

Version History

Introduced in R2015b

See Also

| |

Topics