SetFlushKey()
 Set or get the FLUSH key (finish the READ).
------------------------------------------------------------------------------

 Syntax:

     SetFlushKey( [<nKey>] ) --> <nFlushKey>

 Arguments:

     <nKey> is the scan code value of the key to use as the flush key.

     <nFlushKey> is the current key.

 Returns:

     SetFlushKey() always returns the current flush key value.

 Description:

     SetFlushKey() is used to set or fetch the current flush key (exit READ).
     The flush key when hit while in a READ, will check all VALID clauses on
     all current GETs.  If any fail the READ is is not exited and the first
     failed GET is placed in focus.  If no GETs fail, the READ is exited and
     the LastKill() function is set to FALSE.

     SetFlushKey() by default is K_F10.  Setting SetFlushKey() to 0
     turns its use off.


 Files:  Library is CUACLIP.LIB.