<sas: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:TableView tag.

Syntax

<sas: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:CellContentsImageRenderer ...>
         [<sas:StyleInfo .../>]
         [<sas:SetProperty ...>
            The value to set on the parent tag
         </sas:SetProperty>]
         [Additional <sas:SetProperty> tags...]
      </sas:CellContentsImageRenderer>]
      [<sas:CellContentsLabelRenderer ...>
         [<sas:StyleInfo .../>]
         [<sas:SetProperty ...>
            The value to set on the parent tag
         </sas:SetProperty>]
         [Additional <sas:SetProperty> tags...]
      </sas:CellContentsLabelRenderer>]
      [<sas:CellContentsSimpleTemplateRenderer ...>
         [<sas:SetProperty ...>
            The value to set on the parent tag
         </sas:SetProperty>]
         [Additional <sas: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:CellContentsSimpleTemplateRenderer>]
      [<sas:CellContentsRenderer .../>]
      [<sas:StyleInfo .../>]
      [<sas:SetProperty ...>
         The value to set on the parent tag
      </sas:SetProperty>]
      [Additional <sas:SetProperty> tags...]
</sas: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:CellRenderer tag, extend com.sas.taglib.servlet.tbeans.tableview.CellRendererTag.