HeadingCellPattern Property (ContainerRenderer Object)

The HeadingCellPattern property returns or sets a rendering source that determines how the heading of each table view column is rendered. Read/write.

Syntax

objContRend.HeadingCellPattern

Data Type

String

Remarks

The heading cell is the cell that appears in the heading row above a column in a table view. Its text is specified in the Name property of the Column object. The contents of the HeadingCellPattern property specify the rendering for the heading cell text. The rendering for all the other cells in the table is specified in the CellPattern property.

The rendering of the heading cells can be thought of as being nested. At the outermost level is the cell definition, which encloses the rendering specified by the HeadingCellPattern property:

  <TD WIDTH=[determined by CDO]> [HeadingCellPattern] </TD> 
 

The innermost nesting level is controlled by HeadingCellPattern. If it contains a %value% token, the value from the column's Name property replaces the token. For example, you could set HeadingCellPattern to

  <B>%value%</B> 

to cause all the heading cells to be rendered in bold text. If HeadingCellPattern does not contain a %value% token, the value of the Name property is appended to the end of the HeadingCellPattern string.

The default setting of the HeadingCellPattern property is

  <FONT COLOR=000000 SIZE=2>%value%</FONT> 
 

The cellPattern parameter of the RenderHeading method can override the setting of the HeadingCellPattern property for a particular rendering.