Click above to get retro games delivered to your door ever month!

Cycle of the GET in the FORM

*******************************************************************************
FUNCTION% FORM% [bGET] b (; // METHOD FOR The INPUT GIVEN GODS
                    [nGetState])// in demand Operation
*******************************************************************************

<nGetState> Can engage one of the following values
            +---------------------------------------------------+
            | DE_STATE_INK | Inkey                              |
            | DE_STATE_ADD | Insertation of a new record        |
            | DE_STATE_MOD | Modification of the current record |
            +---------------------------------------------------+

whe the call is DE_STATE_INK mode data is only displayed on the from the,
the other two modes are DE_STATE_ADD, DE_STATE_MOD.

The function tbGet() is seen as effecting a cycle of DATAENTRY for the
control of the form

The function of GET it is very important for the management
of all the objects provided by dBsee4.  That's why it is very important
to the operation, that occurs in the following way.

_ Called to the function
  A--> Immediately after the possible call it will declare the proper
       local variable and then utilize it at the end of the GET cycle,
       return true and quit.

_ Positioning of possible files 1:1
  A--> If the form is arranged with a relationship: of 1 to 1 the file is
       positioned in such a way that the form will display the relationship
       of data correctly.

_ Value of the variable
  A--> Assign the STATIC variable of the object the values that are received
  from the fields.

_ If DE_STATE_MOD assignment of the fields inherited from the memory variable
  A--> Assined to the control they work on the variable to inherit the
       values of the variable.

_ Displaying the form
  A--> After the files are positioned and received the values from the
       variable, the  method %FORM%UPW() is called for the object
       that displays the form.

_ If DE_STATE_INK exit
  A--> If the state of the INKEY is to exit from the get for the function
       and return to the calling function in this only the display of the
       form that is effected.

_ If different from DE_STATE_INK
  A--> it sends to the first control of the application

_ Phase of get tbGet()
  A--> Call the function tbGet() with the start of the get cycle.
       This cycle will continue until the ESC or F10 key is pressed.

  Exit from the GET of DE_STATE_ADD
 A--> Activates the file SEMAPHORE (Locks) so that no other user can update
      the record. then appends to the master and updates the inherited fields

_ Replace fields
  A--> The fields of the GET are written on disk.

_ If DE_STATE_ADD
  +-> Activated the file SEMAPHORE to lock the file, append to the end of
      the file a new blank record with the primary key then write the
      master file the fields and inherited fields.