The CDMLTable class represents tables for CDML contents.

A CDMLTable consists of rows and columns. The rows are numbered from top to bottom, with the top row being 0. The columns are numbered from left to right, with the leftmost column being 0.

By default, the intersection of a row and a column is a cell. You may create cells that span multiple rows and/or columns with CDMLTable.setCell.

The styles of a cell, such as its background color, font, etc., are determined using the following order.

For any style attribute (eg. background color):

• The TextBox object representing the cell (obtained using CDMLTable.getCell) is examined to see if the attribute is defined. If it is defined, its value is used.
  
  
• The TextBox objects representing the prototype of the cells in the column and row of the cell (obtained using CDMLTable.getColStyle and CDMLTable.getRowStyle) are examined to see if the attribute is defined. If the attribute is defined, its value is used. If the attribute is defined in both the column and row prototypes, the prototype that is created later will take precedence.
  
  
• The attribute is taken from the TextBox object representing the prototype of all cells (obtained using CDMLTable.getStyle).
  

For example, if you set the background to white using the prototype for all cells, the background of the whole table will change to white. If you then set the background to grey using the prototype for a row, the background for that row will change to grey. Finally, if you set the background to red using the text box that represents a cell, only that cell will have a red background.