mlreportgen.dom.TableRow Class
Namespace: mlreportgen.dom
Table row
Description
Use an object of the mlreportgen.dom.TableRow class to create a table row.
To see what DOM objects you can append an mlreportgen.dom.TableRow object to,
see Append mlreportgen.dom.TableRow object to DOM class object.
The mlreportgen.dom.TableRow class is a handle class.
Class Attributes
ConstructOnLoad | true |
HandleCompatible | true |
For information on class attributes, see Class Attributes.
Creation
Description
tableRowObj = TableRow
Properties
Methods
Examples
To add content to an empty table, append table entries to table rows and then append the table rows to the table. This example creates this two-by-two table:
Create a document and then create a table that has two columns.
import mlreportgen.dom.*
d = Document();
t = Table(2);Create two table rows.
tr1 = TableRow(); tr2 = TableRow();
Create table entries that contain the content and append the table entries to the rows.
append(tr1,TableEntry('e11')); append(tr1,TableEntry('e12')); append(tr2,TableEntry('e21')); append(tr2,TableEntry('e22'));
Append the table rows to the table.
append(t,tr1); append(t,tr2);
Append the table to the document. Close and view the document.
append(d,t); close(d); rptview(d);
Use the Entries property of an mlreportgen.dom.TableRow object to access the mlreportgen.dom.TableEntry object that corresponds to the entry that you want to format. Format the entry by setting format properties of the TableEntry object or by adding format objects to the Style property of the object. This example changes the text color of the second entry of the second row to red.
import mlreportgen.dom.* d = Document(); t = Table({'e11','e12';'e21','e22'}); t.row(2).Entries(2).Style = {Color('red')}; append(d,t); close(d); rptview(d);
In the resulting table, the text, e22, in the second entry of the second row is red.
Alternatively, you can access a table entry by using the entry method of the mlreportgen.dom.Table object that contains the entry. In the previous example, replace:
t.row(2).Entries(2).Style = {Color('red')};
with:
elem = entry(t,2,2);
elem.Style = {Color('red')};
Create a two-column table.
import mlreportgen.dom.*; myReport = Document('myDoc','html'); table = Table(2); table.Style = {Border('solid'),RowSep('solid'),ColSep('solid')}; table.TableEntriesStyle = {Width('2in'),HAlign('center')};
Create three table rows with entries. Append each entry to a row using append(row,te).
for i=1:3 row = TableRow(); te = TableEntry(); append(te,Text([num2str(i) ' - 1'])); append(row,te); te = TableEntry(); append(te,Text([num2str(i) ' - 2'])); append(row,te); append(table,row); end
Append the table and display the report.
append(myReport,table); close(myReport); rptview(myReport.OutputPath);
More About
Tips
To avoid table formatting errors, create table rows that span the same number of cells, regardless of the number of table entries. For example, the first row in this table has two table entries. The first entry,
Winter, spans two columns and the second entry,Spring, spans one column. The second row has three entries that each span one column.
If you modify only the second row of the table so that the first two entries,
JaunaryandFebruary, each span two columns, and the last entry spans one column, the table format changes.
Version History
Introduced in R2014b
