mlreportgen.ppt.TableRow class

Package: mlreportgen.ppt
Superclasses:

Table row

Description

Row to include in a table.

To add content to a table row, append mlreportgen.ppt.TableEntry objects to the row.

The row with the largest number of table entries determines the number of columns in the table if there are more table entries in the row than the number of rows specified in the mlreportgen.ppt.Table object constructor.

Construction

tableRowObj = TableRow() creates an empty table row object.

Output Arguments

tableRowObj — Table row

mlreportgen.ppt.TableRow object

Table row, returned as an mlreportgen.ppt.TableRow object.

Properties

Style — Default formatting for text in table entries in row

cell array of PPT format objects

Default formatting for text in table entries in a table row, specified as a cell array of PPT format objects that specifies the format for the text. You can specify these mlreportgen.ppt format objects:

• BackgroundColor object

• FontFamily object

• FontSize object

• Bold object

• FontColor object

• Italic object

• Underline object

Children — Children of this PPT API object

cell array of PPT objects

Child elements of this object, specified as a cell array of PPT objects. This property is read-only.

Parent — Parent of this PPT API object

PPT object

Parent of this object, specified as a PPT object. This property is read-only.

Id — ID for PPT API object

character vector | string scalar

ID for PPT API object, specified as a character vector. A session-unique ID is generated as part of object creation. You can specify an ID to replace the generated ID.

Tag — Tag for this PPT API object

character vector | string scalar

Tag for this PPT API object, specified as a character vector. A session-unique tag is generated as part of the creation of this object. The generated tag has the form CLASS:ID, where CLASS is the object class and ID is the value of the Id property of the object.

Specifying your own tag value can help you to identify where an issue occurred during presentation generation.

Methods

Method	Purpose
append	Add content to table row.

Examples

Create a Table with Table Rows

Create a presentation.

import mlreportgen.ppt.*

slidesFile = 'myTableEntryPresentation.pptx';
slides = Presentation(slidesFile);

slide1 = add(slides,'Title and Table');

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.Slide.find method to find objects in the slide with the Name property set to Table. In the default PPT API template, the Title and Table layout slide has an object with the name Table.

contents = find(slide1,'Table');

Replace the table placeholder with table1.

replace(contents(1),table1);

Close the presentation to generate the output.

close(slides);

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

if ispc
    winopen(slidesFile);
end