## <sas-dv:CellRenderer>

Used to set the CellRenderer(s) of the TableView. To set the CellRenderer on a specific row then you must set startRow. If endRow or repeatRowFactor are set, then the CellRenderer applies to all rows between startRow and endRow. If repeatRowFactor is set and endRow is not set, then endRow is assumed to be the last row in the table. These settings also apply to startColumn, endColumn, and repeatColumnFactor. If just startRow and startColumn are set, then only the specified cell will use the CellRenderer. If startRow and startColumn are not set, then the CellRenderer is applied to all cells in the table. When multiple CellRenderers have been applied to the table. Then the last CellRenderer applied for a given cell will be used. The startRow, endRow, repeatRowFactor, startColumn, endColumn and repeatColumnFactor properties are all 1-based since these properties refer to the row and column numbers on the viewer (i.e. TableView).

This tag must be nested within a sas-dv:TableView tag.

### Syntax

`<sas-dv:CellRenderer
[bgColor="java.lang.String"]
[colSpan="1|int"]
[customAttributes="java.lang.String"]
[endColumn="startColumn..int"]
[endRow="startRow..int"]
[headers="java.lang.String"]
[height="int"]
[heightPercentage="int"]
[horizontalAlignment="NONE|LEFT|CENTER|RIGHT|JUSTIFY|CHAR"]
[id="value"]
[noWrap="false|true"]
[repeatColumnFactor="1..int"]
[repeatRowFactor="1..int"]
[rowSpan="1|int"]
[startColumn="1..int"]
[startRow="1..int"]
[styleClassPrefix="java.lang.String"]
[verticalAlignment="NONE|TOP|CENTER|BOTTOM|BASELINE"]
[width="int"]
[widthPercentage="int"]>
[<sas-dv:CellContentsImageRenderer ...>
[<sas-dv:StyleInfo/>]
[<sas-dv:SetProperty ...>
The value to set on the parent tag
</sas-dv:SetProperty>]
[Additional <sas-dv:SetProperty> tags...]
</sas-dv:CellContentsImageRenderer>]
[<sas-dv:CellContentsLabelRenderer ...>
[<sas-dv:StyleInfo/>]
[<sas-dv:SetProperty ...>
The value to set on the parent tag
</sas-dv:SetProperty>]
[Additional <sas-dv:SetProperty> tags...]
</sas-dv:CellContentsLabelRenderer>]
[<sas-dv:CellContentsSimpleTemplateRenderer ...>
[<sas-dv:SetProperty ...>
The value to set on the parent tag
</sas-dv:SetProperty>]
[Additional <sas-dv:SetProperty> tags...]
The html string used as the body of the cell. The string can
have substition variables of the form %COLUMNNAME and the value
for this column will be substituted into the string.
</sas-dv:CellContentsSimpleTemplateRenderer>]
[<sas-dv:CellContentsRenderer .../>]
[<sas-dv:StyleInfo/>]
[<sas-dv:SetProperty ...>
The value to set on the parent tag
</sas-dv:SetProperty>]
[Additional <sas-dv:SetProperty> tags...]
</sas-dv:CellRenderer>`

### Attributes

`bgColor` | The background color for this cell. The StyleInfo tag is now the preferred manner to change colors and other styles on cell renderers.
`colSpan` | The number of columns for this cell to span.
`customAttributes` | A list of attributes in the form of attribute="value", space delimited
`endColumn` | The last column to begin using this CellRenderer. This property is 1-based.
`endRow` | The last row to begin using this CellRenderer. This property is 1-based.
`headers` | Specifies the list of header cells that provide header information for the current data cell. The value of this attribute is a space-separated string of cell names. Those cells must be named by setting their id attribute.
`height` | The height of the cell in pixels.
`heightPercentage` | The height of the cell as a percentage.
`horizontalAlignment` | The horizontal alignment of the cell. Valid values are: LEFT, CENTER, RIGHT, JUSTIFY, CHAR or NONE. The default is NONE (i.e. the browser default).
`id` | Case-sensitive name used to identify the object instance.
`noWrap` | If true, then automatic text wrapping is disabled. If used carelessly, this attribute may result in excessively wide cells.
`repeatColumnFactor` | Specifies every nth column after the startColumn to use this CellRenderer. This property is 1-based.
`repeatRowFactor` | Specifies every nth row after the startRow to use this CellRenderer. This property is 1-based.
`rowSpan` | The number of rows for this cell to span.
`startColumn` | The first column to begin using this CellRenderer. This property is 1-based.
`startRow` | The first row to begin using this CellRenderer. This property is 1-based.
`styleClassPrefix` | The string to prepend to the styleClass property.
`verticalAlignment` | The vertical alignment of the cell. Valid values are: TOP, CENTER, BOTTOM, BASELINE or NONE. The default is NONE (i.e. the browser default).
`width` | The width of the cell in pixels.
`widthPercentage` | The width of the cell as a percentage.

### More Information

To view the documentation for the related TransformationBean, see com.sas.servlet.tbeans.tableview.html.DefaultTableCellRenderer.

If you need to subclass the tag handler class for the sas-dv:CellRenderer tag, extend com.sas.taglib.servlet.tbeans.tableview.CellRendererTag.