07 The class TableRow

This class defines a row in a table. It contains the data for the columns and a few attributes to control the output. The data is saved in an array where the keys are the names of the columns, and the values are strings. It is not necessary to add empty values.

The row type defines the text style that the library will use to print the data of the row.

If you want to add a row to a table, you have to create a TableRow object. The parameter defines the row type. The row type only defines the text style for the row.

// Create a table row of type detail
$row = new ReportLib\TableRow('D');

You can use the following row types:

• ‘H’ for a row that uses the headerTextStyle
• ‘D’ for a row that uses the detailRowTextStyle
• ‘S’ for a row that uses the subTotalRowTextStyle
• ‘T’ for a row that uses the totalRowTextStyle

To add data for the columns, you have to call the setText function with the name of the column as first and the value as the second parameter. The column name must correspond with the columns added the table. It is a clever idea to create constants for them. Here we use simple strings with the names that I used to create the TableFrame.

$row->setText("frametype", "LineFrame");
$row->setText("container", "No");
$row->setText("description", "This frame type represents a line on the report.");
$row->setText("number", "1");

At the end you have to add the row to the table. The library prints them in the same order as you add them to the table.

// Add the row to the table
$table->addDataRow($row);

The output of a table with data looks like this. This is the look of a table when you do not change any attributes of the TableFrame or the TableColumn. It prints a header row and a line below that followed by the data rows.

In the section about the TableFrame class you saw that you can define a lot of things to format a table. You can set the text styles or the lines and the border.