
Click above to get retro games delivered to your door ever month!
X-Hacker.org- CA-Clipper 5.2 . Technical Reference - <b>putvalue()</b>
[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
putValue()
Assign a value to the current column (field)
------------------------------------------------------------------------------
Prototype
ERRCODE putValue(
WORKAREAP wa,
USHORT fieldNum,
ITEM value
)
Arguments
wa is a pointer to self.
fieldNum specifies the ordinal position of the column whose value is
to be assigned.
value is a CA-Clipper Item which contains the value to place at the
current cursor position.
Description
Places a value in the column at the current workarea cursor position.
Default Behavior
You must implement the default behavior of this method through a
subclass.
Implementation Notes
. putValue() should check wa->fields[fieldNum] to retrieve the
column information. This allows your implementation of putValue() to
translate the CA-Clipper value to the RDD's native data store format.
. putValue() must address the shared and read-only status of the
workarea. Calling putValue() must trigger a call to goHot().
. putValue() is one of the few workarea methods that the
CA-Clipper runtime calls without benefit of a higher-level wrapper
function. The following code generates a call to this method:
MYDATA->BobDobbs := cBobDobbs
. If your RDD supports relations, update them with a forceRel()
prior to placing a value in the buffer.
Files: Header file is Rdd.api.
See Also: WORKAREA forceRel() getValue()
Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson