Main Content

append

Class: mlreportgen.ppt.TableRow
Namespace: mlreportgen.ppt

Append table entry to table row

Description

tableEntryObj = append(tableRow,entry) appends a table entry to a table row.

example

Examples

expand all

Create a presentation.

import mlreportgen.ppt.*

ppt = Presentation('myTableEntryPresentation.pptx');
open(ppt);
add(ppt,'Title and Content');

Create a table with three columns.

table1 = Table(3);

Create the first table row.

tr1 = TableRow();
tr1.Style = {Bold(true)};

Create three table entries for the first row.

te1tr1 = TableEntry();
p = Paragraph('first entry');
p.FontColor = 'red';
append(te1tr1,p);

te2tr1 = TableEntry();
append(te2tr1,'second entry');

te3tr1 = TableEntry();
te3tr1.Style = {FontColor('green')};
append(te3tr1,'third entry');

Append the table entries to the first row.

append(tr1,te1tr1);
append(tr1,te2tr1);
append(tr1,te3tr1);

Create the second table row.

tr2 = TableRow();

Create three table entries for the second row.

te1tr2 = TableEntry();
te1tr2.Style = {FontColor('red')};
p = Paragraph('first entry');
append(te1tr2,p);

te2tr2 = TableEntry();
append(te2tr2,'second entry');

te3tr2 = TableEntry();
te3tr2.Style = {FontColor('green')};
append(te3tr2,'third entry');

Append the table entries to the second row.

append(tr2,te1tr2);
append(tr2,te2tr2);
append(tr2,te3tr2);

Append the table rows to the table.

append(table1,tr1);
append(table1,tr2);

Use the mlreportgen.ppt.Presentation.find method to find the slides that have a Content placeholder. In this case, there are two.

contents = find(ppt,'Content');

Replace the table in the second slide with table1.

replace(contents(1),table1);

Generate the presentation. Open myTableEntryPresentation.pptx. On a Windows® platform, you can open the presentation in MATLAB®:

close(ppt);
rptview(ppt);

Sample presentation with a table that contains three columns and two rows. The text in the first column is red, the text in the second column is black, and the text in the third column is green.

Input Arguments

expand all

Table row to append content to, specified as an mlreportgen.ppt.TableRow object.

Table entry to append to a table row, specified as an mlreportgen.ppt.TableEntry object.

Output Arguments

expand all

Table entry, returned as an mlreportgen.dom.TableEntry object.

Version History

Introduced in R2015b