vtread (2) --- read characters from a user's terminal    07/11/84


          | _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 integer function vtread (crow, ccol, clr)
                 integer crow, ccol, clr

          |      Library: vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Vtread'  starts reading characters from the user's terminal
                 into the screen buffers.   'Vtenb'  must  be  called  before
                 'vtread'  to  enable input areas.  'Crow' and 'ccol' are the
                 places at which to start reading.  'Clr' is a  flag  to  let
                 'vtread'  know  if  the  user  wants the input areas cleared
                 before reading.  If 'clr' is YES, then the input  areas  are
                 cleared before reading, otherwise they are left as they are.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 'Clr' is checked to decide whether or not to clear the input
          |      areas,  and if so, proceeds to call 'vt$put' to place blanks
          |      in these areas, and calls 'vtupd' to update  these  changes.
                 It  then  positions  to  the input area at the given row and
                 column.  If  there  is  no  input  area  defined  there,  it
                 positions  to  the  next one defined.  If there are no input
                 areas defined, the  function  return  is  set  to  zero  and
                 'vtread'  returns.   If  an  input area has been defined, it
                 calls 'vt$get' to read  characters  from  the  terminal  and
                 place  them  on the screen, until a termination character is
                 typed (RETURN,  KILL_RIGHT_AND_RETURN,  MOVE_UP,  MOVE_DOWN)
                 and  then  returns  the  termination  code  as  the function
                 return.


            _C_a_l_l_s

                 vt$put, vt$get, vtupd


            _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

                 none


            _S_e_e _A_l_s_o

                 _I_n_t_r_o_d_u_c_t_i_o_n _t_o _t_h_e _S_o_f_t_w_a_r_e _T_o_o_l_s _T_e_x_t _E_d_i_t_o_r (Se section),
                 and other vt?* routines (2)








            vtread (2)                    - 1 -                    vtread (2)