home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / progc / cfuncs.arj / INOUT.DOC < prev    next >
Encoding:
Text File  |  1991-08-26  |  1.8 KB  |  61 lines
  1. #include <stdio.h>
  2. #include "inout.h"
  3. /*----------------------- inout ------------------------------*/
  4. /*DESCRIPTION: Allows entry, editing, displaying, and clearing*/
  5. /*    of a field of data with specified length, position,   */
  6. /*    color attributes, and data types.  Handles function   */
  7. /*    keys, tab keys, and arrow keys.                  */
  8. /*                                  */
  9. /*INPUT:
  10. --------VARIABLE---------------------DESCRIPTION--------------
  11.     X    ;X COORDINATE TO START ENTERING INFORMATION
  12.     Y    ;COLUMN TO START ENTERING INFORMATION
  13.     len    ;MAX LENGTH OF DATA TO BE ENTERED
  14.     FG    ;FOREGROUND COLOR
  15.     BG    ;BACKGROUND COLOR
  16.     Data    ;STRING THE ENTRY IS STORED IN
  17.  
  18.     Mode    ;0 = ENTER
  19.         ;1 = EDIT WITH CURSOR AT THE END OF THE DATA FIELD
  20.         ;2 = EDIT WITH CURSOR AT THE BEGINNING OF THE FIELD
  21.         ;3 = DISPLAY THE DATA FIELD
  22.         ;4 = CLEAR THE DATA FIELD
  23.  
  24.     Type    ;0 = ALPHANUMERIC (DEF)
  25.         ;1 = NUMERIC
  26.         ;2 = PHONE # (999)-999-9999
  27.         ;3 = SOCIAL SECURITY NUMBER 999-99-9999
  28.         ;4 = DATE - MM/DD/YY
  29.         ;5 = PASSWORD
  30.         ;6 = UPPER CASE AN
  31.         ;7 = INTEGER
  32.         ;8 = REAL
  33.         ;9 = A SYSTEM GENERATED NUMBER
  34.  
  35.     show    ;0 = DOTS (DEF)
  36.         ;1 = BLANKS
  37.         ;2 = UNDERSCORE
  38.         ;3 = NO SHOW
  39.  
  40.     vkey    ;CHAR 1 -- F = ALLOW FUNCTION KEY USE
  41.         ;CHAR 2 -- A = ALLOW UP AND DOWN ARROW USE
  42.         ;CHAR 3 -- T = ALLOW TAB AND BACKTAB EXIT FROM INOUT
  43.  
  44.     ret    INPUT
  45.         ;0 = NON-DESTRUCTIVE ENTER KEY IN EDIT MODE (DEF)
  46.         ;1 = DESTRUCTIVE ENTER KEY IN EDIT MODE
  47.         OUTPUT
  48.         ;0 = FIELD FILLED
  49.         ;1-12 = FUNCTION KEY PRESSED
  50.         ;13 = ENTER KEY PRESSED
  51.         ;14 = ESC KEY
  52.         ;15 = UP ARROW
  53.         ;16 = DOWN ARROW
  54.         ;17 = TAB
  55.         ;18 = BACKTAB
  56. USES: strspc, strnchr, OnCursor, GetCursor, SetCursor, rtrim, rtrimlen,
  57.     CheckNum
  58. ---------------------------------------------------------------*/
  59. inout (int X, int Y, int len, int FG, int BG, void *Data, int Mode,
  60.     int Type, int show, char *vkey, int *ret)
  61.