ADD-CALC-COLUMN( ) method

ADD-CALC-COLUMN( ) method

Creates a browse column from the specified properties and returns the handle of the new column. This method can be used only after the browse’s query attribute has been set.

Return type: HANDLE

Applies to: BROWSE widget
Syntax
ADD-CALC-COLUMN( datatype-exp , format-exp , initial-value-exp , label-exp     
[ , pos [ , widget-type ] ] ) 
datatype-exp

Character expression specifying the data type. Valid values are "CHARACTER", "DATE", "DECIMAL", "INTEGER", "INT64", or "LOGICAL".

format-exp

Character expression specifying the column’s format.

initial-value-exp

Character expression specifying the initial value. This may be a null string.

label-exp

Character expression specifying the column’s label.

pos

The optional integer value position of the browse column. If pos = 2, the column is the second column. If the position is not specified or the position is invalid, the new column is added at the end of the columns.

widget-type

An optional character expression specifying the widget type of the column. Valid values are "COMBO-BOX", "DROP-DOWN", "DROP-DOWN-LIST", "FILL-IN" and "TOGGLE-BOX". The default value is "FILL-IN".

If datatype-exp is not "LOGICAL", specifying "TOGGLE-BOX" as the widget type generates a run-time error.

The widget-type parameter is ignored in character mode.

The following is an example of adding a column in the browse’s fifth position using this method:
CalcHnd5 = BrwsHndl:ADD-CALC-COLUMN("char", "AAA-99999", "ORD-37854",          
"OrdNum", 5). 
The ADD-CALC-COLUMN( ) method may be used on a static browse as well as on a dynamic browse.

If the browse is already displayed, the REFRESH( ) method should be applied to the browse after columns are added using ADD-CALC-COLUMN( ). This will initially populate the viewport for the calculated column. The ROW-DISPLAY trigger would normally populate the column, but when ADD-CALC-COLUMN is being executed, the ABL calc-column handle is not yet set and, thus, cannot initially populate it.

Syntax
ADD-CALC-COLUMN( `datatype-exp , format-exp , initial-value-exp , label-exp` [ , `pos` [ , `widget-type` ] ] )

CalcHnd5 = BrwsHndl:ADD-CALC-COLUMN("char", "AAA-99999", "ORD-37854", "OrdNum", 5).

OpenEdge Release 10.2B