[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
addField()
Add a column (field) to the work area
------------------------------------------------------------------------------
.Prototype
ERRCODE addField(
AREAP wa,
LPDBFIELDINFO lpdbFieldInfo
)
Arguments
wa is a pointer to self.
lpdbFieldInfo is a pointer to a structure containing information
about a column in the work area.
Description
addField() adds a column specified by lpdbFieldInfo to the wa work area.
Default Behavior
addField() inserts the column referred to by lpdbFieldInfo into the data
table referenced by the AREA structure. The new column is added to the
end of the wa->lpFields structure. wa->uiFieldCount is updated to
reflect the addition.
Note: Call setFieldExtent() prior to adding fields to the AREA
structure. setFieldExtent() sizes and clears the wa->lpFields
structure, readying it for use.
Warning! wa->uiFieldCount must be less than wa->uiFieldExtent
or an assertion error will be raised.
Implementation Notes
. Most implementations should use the default behavior for
addField(). However, if you change the addField() implementation, be
aware of the order imposed on adding fields to the work area
structures.
Files Header file is Rdd.api.
See Also:
AREA
DBFIELDINFO
createFields()
setFieldExtent()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson