home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / USCX / PTOOLS.ZIP / PTOOLENT.DOC < prev    next >
Text File  |  1985-02-23  |  5KB  |  113 lines

  1.  PTOOLENT.INC   Copyright 1984  R D Ostrander                   Version 1.0
  2.                                  Ostrander Data Services
  3.                                  5437 Honey Manor Dr
  4.                                  Indianapolis  IN  46241
  5.  
  6.  
  7.  This Turbo Pascal include file is a display and data entry tool. It Displays
  8.  a given String (or Character Array), Integer, or Real (Dollar) data field
  9.  in a given screen area and allows the operator to make changes via the
  10.  keyboard. It allows the operator to end the editing using many ending
  11.  keys and passes information about those keys to the calling program.
  12.  
  13.  
  14.  This program has been placed in the Public Domain by the author and copies
  15.  may be freely made for non-commercial, demonstration, or evaluation purposes.
  16.  Use of these subroutines in a program for sale or for commercial purposes in
  17.  a place of business requires a $20 fee be paid to the author at the address
  18.  above.  Personal non-commercial users may also elect to pay the $20 fee to
  19.  encourage further development of this and similar programs. With payment you
  20.  will be able to receive update notices, diskettes and printed documentation
  21.  of this and other PTOOLs from Ostrander Data Services.
  22.  
  23.  
  24.   PTOOL, and PTOOLxxx are Copyright Trademarks of Ostrander Data Services.
  25.  
  26.  Turbo Pascal is a Copyright of Borland International Inc.
  27.  
  28.  
  29.  
  30.  The Call format for PTOOLENT is:
  31.  
  32.     Set Data            <String, Integer, or Real>      initial display value.
  33.     Set DataType        <Char>                                   type of edit.
  34.     Set DisplaySize     <Integer>                number of spaces for display.
  35.     Set DisplayDecimals <Integer>                       for Real numbers only.
  36.     Set ReturnCode      <Integer>      need not be set but must be a variable.
  37.     GoToXY (X, Y)                            to set the Display Area location.
  38.     PTOOLENT (Data, DataType, DisplaySize, DisplayDecimals, ReturnCode);
  39.  
  40.  
  41.  
  42.     Examples:     Var CustomerName : String [24];
  43.                       ReturnCode   : Integer;
  44.                   Begin
  45.                   CustomerName := ' ';
  46.                   Gotoxy (1,1)
  47.                   PTOOLENT (CustomerName, 'S', 24, 0, ReturnCode);
  48.  
  49.     See companion program PTOOLENT.PAS for further examples.
  50.  
  51.  
  52.     Note that the DisplaySize must be > DisplayDecimals + 1.
  53.  
  54.     Invalid data and cursor movements cause beeps to the operator.
  55.  
  56.  
  57.  Editting Keys for use by the operator are:
  58.  
  59.          Left Arrow       : Move cursor to left one position
  60.          Right Arrow      : Move cursor to right one position
  61.          Ctrl-Left Arrow  : Move cursor to 1st position
  62.          Ctrl-Right Arrow : Move cursor to first position past last character
  63.          Tab              : Move cursor right to next word
  64.          Shift-Tab        : Move cursor left to previous word
  65.          Backspace        : Erase character to left of cursor
  66.          Del              : Erase character under cursor
  67.          Ctrl-E           : Erase editing area
  68.          Ctrl-F           : Fill field with character to left of cursor
  69.          Ctrl-X           : Erase all characters from cursor on
  70.          Ctrl-L           : Left justify data
  71.          Ctrl-R           : Right justify data
  72.          Ctrl-S           : Start Editting over
  73.          Ctrl-N or Ctrl-Q : Quit with no change in data
  74.          Ctrl-P           : Retreive Previous data or Ctrl-E(rased) data
  75.          Ctrl-U           : Change all data to Upper Case
  76.          Ctrl-D           : Change all data to Lower Case
  77.          Ins              : Toggle Insert function on/off
  78.  
  79.          Alt-Numerics may be used to enter character graphics codes
  80.  
  81.  
  82.  
  83.   Return codes are:
  84.  
  85.                   0 = Esc
  86.                   1 = C/R or Ctrl-N or Ctrl-Q
  87.                   2 = (Filled Field)
  88.                   3 = Ctrl-Break or Ctrl-C  (if $C- not set)
  89. 16-26, 30-38, 44,50 = Alt-Alphabetics
  90.               59-68 = F1 - F10
  91.                  71 = Home                 These are the codes returned to the
  92.                  72 = Up Arrow             calling program in the ReturnCode
  93.                  73 = PgUp                 field when the operator ends the
  94.                  79 = End                  editing by pressing one of these
  95.                  80 = Down Arrow           keys. Other key combinations can
  96.                  81 = PgDn                 also cause an end of edit & return
  97.               84-93 = Shift F1 - F10       spurious codes. Note that the code
  98.              94-103 = Ctrl F1 - F10        of 2 is returned when the operator
  99.             104-113 = Alt F1 - F10         enters a character (or space) in
  100.                 114 = Ctrl-PrtSc           the last position of the field.
  101.                 117 = Ctrl-End
  102.                 118 = Ctrl-PgDn
  103.                 119 = Ctrl-Home
  104.                 132 = Ctrl-PgUp
  105.  
  106.  
  107.  Now go out and try PTOOLENT and by all means, look at the code of both
  108.  PTOOLENT.PAS and PTOOLENT.INC to completely understand how to incorporate
  109.  the Ostrander Data Services product into your programs.
  110.  
  111.  Write to find out about other ODS software available that might not be
  112.  on this bulletin board.
  113.