Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- CA-Clipper 5.2 . Technical Reference - <b>putvalue()</b> http://www.X-Hacker.org [<<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