SetDataField

SetDataField(iStart, sPackFormat$)

Sets the datafield property to the specified numeric field information

Applies to: Button , Grid , GridCell , GroupBox , KCMLEdit , Picture Button , Static Text

Introduced in KCML version 6.10

SetDataField(sFldName$)

Sets the datafield property to the specified FLD

Applies to: Button , Grid , GridCell , GroupBox , KCMLEdit , Picture Button , Static Text

Introduced in KCML version 6.10

SetDataField

This obsolete method was used to set the data aware field information for a grid cell in an easier manner than setting DataField integer property directly. The grid must already have either DataSource or DataBind set. The method is polymorphic with two variants.

• The first parameter is the field start and the second the format of the string. This can be used for both numeric and string fields. If a field information is contained in a field variable, the POS() and PACK() functions may be used to deduce the start and format.
• The other variant applies only when bound against a DataBind object specified in the DataBind property of the grid. It takes a single string argument corresponding to one of the FLD names in the bound record. The type information is then deduced from the corresponding FLD in the bound DEFRECORD.

The Type$ property is determined automatically based on the format given either explicitly or implied from the FLD.

This second method was superseded by the DataField$ column property. For more about data binding and the DataBind control see here..

REM Numeric field example
.gridcell(2,2).SetDataField(POS(.nfld), PACK(.nfld))
REM String field example
.gridcell(2,3).SetDataField(POS(.sfld), PACK(.sld))
REM explicit field
.gridcell(2,4).SetDataField(10, "UNUM(10,2)")
REM example using DataBind and a field name
.gridcell(2,5).SetDataField("PARTNUM")

Compatibility

This method was experimentally introduced for KCML 6.10 but later withdrawn in KCML 6.11 in favor of the DataField$ column property. It is still supported for backward compatibility for applications not binding agaianst records but may be withdrawn in a future KCML.

See also

Button methods, properties and events. Grid methods, properties and events. GridCell methods, properties and events. GroupBox methods, properties and events. KCMLEdit methods, properties and events. Picture Button methods, properties and events. Static Text methods, properties and events.