Super Header
  


ADD [ SUPER ] HEADER TO <oBrw>
FROM [ COLUMN ]
<nFromCol>
TO [ COLUMN ]
<nToCol>
TITLE | HEADER
<cHeader>
[ HEIGHT
<nHeight> ]
[ COLOR | COLORS
<aColors> ]
[ 3DLOOK | LOOK3D ]
[ FONT
<uFont> ]
[ NOGRID | NOLINES ]
[ BITMAP ]
[ ADJUST ]
[ TRANSPARENT ]
[ HORZ [ ALIGN ]
<nHAlign> ]
[ VERT [ ALIGN ]
<nVAlign> ]

With this command are created headers shown on top the normal TSBrowse Headers, aligned with the embraced columns (FROM/TO). They can be of type text that are shown centered, or bitmaps getting this appearance (among others):
  
January
February
Units
Import
Units
Import
12345
12345
12345
12345

This command must be invoked after the columns of the Browse have been defined.

Parameters:
<oBrw> ( REQUIRED ) Reference to the TSBrowse object on which the Super Headers will be added.

<nFromCol> ,<nToCol> ( REQUIRED ) Range of the Browse columns (From/To) on top of which the Super Header will be aligned.

<cHeader> ( REQUIRED ) Expression whose contents will be shown as Super Header. It can be a constant expressed between quotation marks, a text type variable, a reference to a Bitmap object, or its handler ; or also a Code Block whose evaluation will return any of the above mentioned data types.

<nHeight> ( OPTIONAL ) Height in pixels of the Super-Header. If omitted, TSBrowse will calculate the height based on the font (uFont) used, or on the height of the BitMap. If more than one Super-Headers are defined, the final height for every one will be the higher between them. In the case of BitMaps, if nHeight is smaller than the BitMap height, and the clause ADJUST is defined, nHeight will be respected and the BipMap will be adjusted to nHeight, otherwise the height of the BitMap will prevail.

<aColors> ( OPTIONAL ) Simple list of 3 color expressions in the following order:

1. - Text Color (will not apply on BitMaps)
2. - Background Color
3. - Line Color

Example: COLORS CLR_BLACK, CLR_HGRAY, CLR_RED

If
aColors is omitted, the corresponding column Header colors of the first column in the range will apply.

<uFont> ( OPTIONAL ) A Tfont object reference, or its handler. Each Super_Header can use different fonts.
If
uFont is omitted, the font used for the normal Header will be applied.

<nHAlign> ( OPTIONAL ) A digit indicating the horizontal alignment of the Super-Header according to the following:

0 = DT_LEFT = Left alignment
1 = DT_CENTER = Centered
2 = DT_RIGHT = Right alignment

<nVAlign> ( OPTIONAL ) A digit indicating the vertical alignment of the Super-Header according to the following:

0 = DT_TOP = Align Top
1 = DT_CENTER = Centered
2 = DT_BOTTOM = Align Bottom


Optional Logical Clauses:

3DLOOK, OOK3D Indicates that the Super-Header will appear in 3D. If omitted, will appear without this attribute.
NOGRID, NOLINES Indicates that the Super-Header will be shown without grid lines.

BITMAP Indicates that uHead is a BitMap.

ADJUST The BitMap will be adjusted to the dimensions of nHeight and the width of the column.

TRANSPARENT The background color of the BitMap will be the same as the background color of the Super-Header.