home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / CLIPPER / PPP.ZIP / README.1ST < prev   
Text File  |  1994-03-21  |  5KB  |  104 lines
  1.                 P O W E R   P A C K E D   P R I N T O U T S
  2.  
  3.  
  4.                                 Overview
  5.  
  6.  
  7.          Power Packed Printouts is a shareware library of functions
  8.          that enables you to code reports packed with features your
  9.          users will love.
  10.  
  11.          Let the user specify Screen, Print, or File for output.  If he
  12.          chooses Screen, he can browse the file, panning side to side
  13.          for reports wider than the display.  He'll use the PageUp and 
  14.          PageDown keys to move up and down through the report, no matter
  15.          how many pages.  He'll see on-screen exactly the same report
  16.          he'll get when he prints it.
  17.  
  18.          Other Screen options lets the him press Alt-S to search for
  19.          any string of text, and Alt-P lets him print what he sees to
  20.          any printer port or text file.
  21.  
  22.          You specify page and column headers, lines per page, printer
  23.          set-up strings, etc. via a call to an accessor function.  The
  24.          accessor function returns the current value and installs a new
  25.          value, if you pass it in, just the way Clipper's SET() functions
  26.          work.  You will never have to keep count of line or page numbers
  27.          again.  Your margins will always be exactly correct.  You'll
  28.          never have to remember to reset the printer.  You'll never have
  29.          to link in a third-party C file viewer or RUN an external
  30.          viewer program.  It's all 100% Clipper 5.2 code.
  31.  
  32.          Look at PPP.ch to see all the values you can set.  Look at
  33.          PPPdemo.prg for a sample program that prints a report consisting
  34.          of the files in the current directory.
  35.  
  36.          You can access the four global functions to get started in just
  37.          minutes.  And since the first is an accessor function to set
  38.          static variables that control everything else, there's no long
  39.          set of parameters to pass.
  40.  
  41.          pppSet( < PPP_CONSTANT >, [ <new value> ] )
  42.  
  43.          This function is a get/set function.  The first parameter is a
  44.          manifest constant from PPP.ch.  The function returns the value
  45.          currently stored in the static variable at that location.  You
  46.          can optionally pass a second parameter that sets a new value 
  47.          into the the static variable.
  48.  
  49.          pppInit( [ DESTINATION ] )
  50.  
  51.          This function lets the user select a report destination: Screen,
  52.          Printer, File, or Exit without creating the report.  You can 
  53.          optionally pass in a single character parameter, 'S' for screen
  54.          or 'P' for printer.
  55.  
  56.          pppLine( < xItem >, [ cMode ] )
  57.  
  58.          This function lets you pass a variable to the library for it to
  59.          create the next line of the report.  The xItem parameter can take
  60.          any of several forms.  If it is a character data type the function
  61.          uses it as-is.  If it is a numeric data type the function str()'s
  62.          it and prints.  If it's a date type the function dtoc()'s it.  If
  63.          it's a logical, the function prints Y for true or N for false.  If
  64.          it's a B data type, the function eval()'s it.
  65.  
  66.          If xItem is an array, each element of the array is evaluated and
  67.          a report line is concatenated from the individual elements.  Each
  68.          element can be any of the types above.  The program inserts space
  69.          between each item based on the value returned from the static
  70.          pppSet( PPP_COLUMNSPACE ).
  71.  
  72.          As an additional power feature, an element of xItem can also be
  73.          an array of five elements that let you fully define the format of
  74.          any individual column:
  75.          
  76.          xItem[ i, PPP_ITEMDATA ]     := C, N, D, L, or B data type.
  77.          xItem[ i, PPP_ITEMLEFTSTR ]  := ' | ', for example.
  78.          xItem[ i, PPP_ITEMRIGHTSTR ] := ' | ', for example.
  79.          xItem[ i, PPP_ITEMWIDTH ]    := 12, for example.
  80.          xItem[ i, PPP_ITEMPICTURE ]  := '999,999,999', for example.
  81.  
  82.          This library is shareware.  You may use it for thirty days to
  83.          see if it is appropriate for you.  If after thirty days you   
  84.          decide to continue using it, you must register it.  With your
  85.          registration you will receive the full source code, so you can
  86.          add to it, modify it, or customize it to fit your own needs.
  87.          Once you get the source code, you may prefer to include the
  88.          single PPP.OBJ file in your link script, rather than link in
  89.          PPP.LIB.
  90.  
  91.          If you have any questions, please post them to me on CompuServe
  92.          at 73060,1302 or leave a message at (214) 867-5094 or fax your
  93.          question to (214) 985-9419.
  94.  
  95.                                      -- Steve Woolstenhulme
  96.  
  97.  
  98.          Log of changes:
  99.  
  100.          March 21, 1994:   Added PPP_DESPOOL directive to let you specify
  101.                            immediate despooling, rather than gathering
  102.                            the entire file FIRST to disk.  Default .f.,
  103.                            since that can be a problem on a network.
  104.