append

Class: mlreportgen.ppt.Table
Namespace: mlreportgen.ppt

Append row to table

Syntax

rowObj = append(table,row)

Description

rowObj = append(table,row) appends a row to a table.

Examples

Create a Table with Table Rows

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

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 the myTableEntryPresentation.pptx. On a Windows^® platform, you can open the presentation in MATLAB^®:

close(ppt);
rptview(ppt);

Input Arguments

table — Table to append row to

mlreportgen.ppt.Table object

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

row — Row to append to table

mlreportgen.ppt.TableRow object

Row to append to table, specified as an mlreportgen.ppt.TableRow object.

Output Arguments

rowObj — Appended table row

mlreportgen.dom.TableRow object

Appended table row, returned as an mlreportgen.dom.TableRow object.

Version History

Introduced in R2015b