home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / progbas / qb4tb520.arj / HELPFILE.ZIP / REVINPUT.HLP < prev    next >
Encoding:
Text File  |  1990-10-25  |  2.1 KB  |  56 lines
  1. REVINPUT is the standard Toolbox data-entry routine.
  2.  
  3.                Arguments:
  4.  
  5. Max%        =  maximum number of characters which can
  6.                be accepted.
  7. Default$    =  default string which can be accepted by
  8.                just pressing the <Enter> key.
  9. Context%    =  set TRUE if context-sensitive help is
  10.                available, in which case ... 
  11. Topic$      =  name of the HELP Topic file to display
  12.                whenever the <F1> key is pressed. 
  13. ReturnCode% =  If entry is terminated by anything
  14.                other than the <Enter> key, this
  15.                variable will contain an explanatory
  16.                return code ..
  17. All the usual editing keys are supported and entry may
  18. be terminated by either a carriage-return or <Escape>,
  19. in which case any keyed-in characters will be ignored.
  20.  
  21. <L.Arrow>   =  Move cursor one character to the left
  22. <R.Arrow>   =  Move cursor one character to the right
  23. <Home>      =  Move cursor to first character of field
  24. <End>       =  Move cursor to last character of field
  25. <Ctrl End>  =  Clear from current cursor position to
  26.                the end of the entry field.
  27. <Insert>    =  Toggle between Insert and Overtype.
  28. <Delete>    =  Delete character under the cursor.
  29. <BackSpace> =  Replace character under cursor with a
  30.                blank space and move the cursor one
  31.                character to the left.
  32. <F1>        =  pop up on-line HELP screen.
  33.  
  34. REVINPUT is also designed to be part of a  full-screen
  35. data-entry system. Your program can examine the return
  36. code  to determine whether the operator just wishes to 
  37. terminate entry, or move forwards or backwards between
  38. a number of entry fields.
  39.  
  40. Return Codes:   
  41.  
  42. 1  =  <Escape>    abort entry returning a null string
  43. 2  =  <F2>        repeat previous entry for this field
  44. 3  =  <Up Arr>    pressed, move to previous field 
  45. 4  =  <Dn Arr>    pressed, move to next field
  46. 5  =  <Pg Up>     pressed, move to top of screen
  47. 6  =  <Pg Dn>     pressed, move to end of screen
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  See also DATEINPUT for a keyboard routine specially
  54.  designed to ask the operator for a date!!!!
  55.  
  56.