xHarbour Reference Documentation > Class Reference (textmode)

TBColumn()

Creates a new TBColumn object.

Syntax

TBColumn():new( <cHeading>, <bData> ) --> oTBColumn

Arguments

<cHeading>

This is a character string which is displayed in the column heading of a TBrowse() display.

<bData>

This is a code block which returns the data to be displayed within the data area of one column of a TBrowse() display.

Return

Function TBColumn() returns a new TBColumn object and method :new() initializes the object.

Description

TBColumn objects are required for creating a browser in text mode applications. They are always used in conjunction with a TBrowse() object which is a container for TBColumn objects. A TBColumn object contains all information required for displaying a single column of data in a browse view. As a consequence, TBColumn objects are useless on their own and must be added to a TBrowse object with its :addColumn() method.

Instance variables

:block

Code block to retrieve data for the column.

:cargo

Instance variable for user-defined purposes.

:colorBlock

Code block selecting the color of data cells depending on their values

:colSep

Characters used as vertical column separator.

:defColor

Array holding numeric indexes into the color table of TBrowse

:footing

Character string displayed as column footing.

:footSep

Characters used as horizontal separator for column footings.

:heading

Character string displayed as column heading.

:headSep

Characters used as horizontal separator for column headings.

:picture

Character string holding a PICTURE format.

:postBlock

Code block for data validation.

:preBlock

Code block for edit validation.

:width

Numeric width of column.

Methods

:setStyle( <nStyle>, [<lNewOnOff>] ) --> lOldOnOff

Retrieves or changes a column style.

Info

See also:	TBrowse()
Category:	Object functions
Header:	tbrowse.ch
Source:	rtl\tbcolumn.prg
LIB:	xhb.lib
DLL:	xhbdll.dll

Example

// Refer to function TBrowse() for an example of TBColumn usage.