home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / TURBOPAS / TURBSCR.LBR / SCREEN.DQC / SCREEN.DOC
INI File  |  2000-06-30  |  7KB  |  149 lines
  1. [SCREEN.DOC]
  2.  
  3.  
  4. SCREEN.PAS is a Turbo Pascal source code file that, when compiled, can be
  5. used to create editable input screens for your programs. The files created
  6. from the program are:
  7.  
  8.      <filename>.INC - the source code file to include in your application
  9.                       program.
  10.  
  11.      <filename>.SCR - the screen file that can be edited to make changes
  12.                       in a previously created screen.
  13.  
  14.  
  15. Main menu selections:
  16.  
  17.      <1> Select file - you will be prompted to enter <N>ew or <O>ld file.
  18.                        you will then be prompted to enter the filename.
  19.                        if the filename is already in use, you will be asked
  20.                        if you wish to erase the file. If not you will be
  21.                        returned to the main menu, otherwise, the files will
  22.                        be rewritten.
  23.  
  24.                        The filename you select will be used in the files
  25.                        shown above and also used to name the pascal procedure
  26.                        in the source code of <filename>.INC
  27.  
  28.  
  29.                        i.e. Enter Filename MYPROG
  30.                        will produce:
  31.  
  32.                        MYPROG.SCR
  33.                        MYPROG.INC (the firstline of source code will be
  34.                                    procedure MYPROG;                  )
  35.  
  36.      <2> Draw Screen - will clear the the screen and place the cursor in
  37.                        the upper left corner. If you are editing an existing
  38.                        file, the file will be displayed so you will not
  39.                        accidently overwrite it.
  40.  
  41.                        Any variables you will wish to write or read must be
  42.                        declared externaly to this screen procedure.
  43.  
  44.                        To have the source code write a variable the following
  45.                        format is used:
  46.  
  47.                                       @YourVariableName
  48.  
  49.                                       will produce the source code
  50.  
  51.                                       gotoXY( 1, 1); write(YourVariableName);
  52.  
  53.  
  54.                        NOTE there is no space between @ and the variable
  55.                             name. Also, one space must follow the variable
  56.                             name before any other text can be written.
  57.  
  58.                        To have the source code read a variable the following
  59.                        format is used:
  60.  
  61.                                       #YourVariableName
  62.  
  63.                                       will produce the source code
  64.  
  65.                                       gotoXY( 1, 1); read(YourVariableName);
  66.  
  67.  
  68.                        NOTE there is no space between # and the variable
  69.                             name. Also, one space must follow the variable
  70.                             name before any other text can be written.
  71.  
  72.                        Options - select options by pressing the backslash (\)
  73.                        you may then either draw a verticle from the cursor
  74.                        position to the bottom of the screen by pressing V
  75.                        or a horizontal line from the cursor position to the
  76.                        right side of the screen by pressing H.  Where a
  77.                        horizontal line crosses a verticle line a '+' will
  78.                        be printed.
  79.  
  80.                         +-----------------------------------------------+
  81.                         |                                               |
  82.                         |                                               |
  83.                         +-----------------------------------------------+
  84.  
  85.                        Selecting the Q option will quit the draw screen
  86.                        mode and return you to the main menu.
  87.  
  88.                        The program will accept all printable characters
  89.                        from ASCII 32 to ASCII 126 with the exception of
  90.                        the backslash '\' which, as mentioned,  puts the
  91.                        program in the option mode.
  92.  
  93.                        The cursor control keys are based on the arrow keys
  94.                        of my KayPro10 and use the following codes:
  95.  
  96.                             ^M  -  <RETURN> with automatic tab to prior
  97.                                    line indentation.
  98.                             ^K  -  Up Arrow
  99.                             ^L  -  Right Arrow
  100.                             ^J  -  Down Arrow
  101.                             ^H  -  Left Arrow  <BACKSPACE>
  102.                             <DEL> will move the cursor one position to
  103.                                   the left and delete the character under
  104.                                   the cursor.
  105.  
  106.  
  107.  
  108. <3> Display Screen   - will display the screen in the current named
  109.                        .SCR file.
  110.  
  111. <4> Save Screen      - will write the <filename>.INC and <filename>.INC to
  112.                        the currently logged disk.
  113.  
  114.                        The source code produced and saved in the
  115.                        <filename>.INC file will structured to write all
  116.                        of the text first, the write(variables) next and
  117.                        then the read(variables) sequentially as there are
  118.                        presented on the screen i.e. top to bottom left to
  119.                        right.
  120.  
  121. <5> Quit             - Before exiting the program, if you have edited a
  122.                        file, the program will prompt you to see if you
  123.                        wish to save the screen files.
  124.  
  125.  
  126. Files included
  127.  
  128.      TESTSCR.SCR - an editable screen file to demonstrate SCREEN.PAS
  129.      TESTSCR.INC - source code produced from the above
  130.      TESTSCR.PAS - a sample program using the above include file
  131.      SCREEN.PAS  - source code for the screen generator
  132.      SCREEN.DOC  - this file
  133.  
  134. Suggested usage - using Turbo Pascal compile the SCREEN.PAS to a .COM file.
  135.                   You may then call the program from the Turbo Pascal editor
  136.                   using the X (execute option) and create your screen. Upon
  137.                   exiting SCREEN.COM you will be returned to the Turbo Pascal
  138.                   editor and your application program. At the appropriate
  139.                   place, enter (*$I <filename>.INC *). See the example files
  140.                   TESTSCR.INC, TESTSCR.SCR and TESTSCR.PAS
  141.  
  142.  
  143.  
  144. Released to the Public Domain 02/09/85. Not to be used for profit or resale.
  145.  
  146. David McCourt
  147. R D 2
  148. Williamsport, PA 17701
  149.