home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 2 / ctrom_ii_b.zip / ctrom_ii_b / PROGRAM / CLIPPER / SYSWIN / SYSWIN.DOC < prev    next >
Text File  |  1992-10-28  |  3KB  |  74 lines
  1.  
  2.   Function SAV_SWIN2( nTRow, nLCol, nBRow, nRCol, cColorStr, lShaded)
  3.   Function RST_WIN2( )
  4.   Function CLR_WIN( nTRow, nLCol, nBRow, nRCol, cColorStr)
  5.   Function DISPWIN( nTRow, nLCol, nBRow, nRCol, cColorStr)
  6.   Function SCR_DULLING( cStr )
  7.   Function SCR_TO_TXT( nTop, nLft, nBot, nRit )
  8.  
  9.   by Rod Cushman
  10.   May 15, 1992
  11.  
  12.  
  13.   Your encouraged to modify and improve this code.  Please contact me
  14.   at the address below with your comments & suggestions.
  15.  
  16.   The functions CLR_WIN(), DISPWIN(), SCR_DULLING() and SCR_TO_TXT() are 
  17.   miscellaneous window functions which I have in my library.  CLR_WIN() 
  18.   and DISPWIN() are basically the same function.  I kept the dual 
  19.   definition because some of the other programs I have linked into my 
  20.   applications call DISPWIN(); all of mine call CLR_WIN() or 
  21.   SAV_SWIN2().  I kept the extra function for compatibility purposes.
  22.  
  23.   Use SAV_SWIN2() when you want to save the region of the screen behind 
  24.   the box being painted.  A subsequent call to RST_SWIN2() (with no 
  25.   parameters required) will restore the prior screen region and color.
  26.  
  27.   Use CLR_WIN() or DISPWIN() when you don't care about the region behind 
  28.   the painted box.
  29.  
  30.   If you configured Clipper 5.0 according to Nantucket's installation 
  31.   the CLIPWIN.BAT file should compile & link the program TEST_WIN.PRG.  
  32.   Or you can compile syswin.prg as a standalone with the /n parameter 
  33.   and include it with your application.  The file does rely upon Clipper 
  34.   header files (box.ch).
  35.  
  36.  1)     Function SAV_SWIN2() saves the current background screen and 
  37.         color values.  The parameters cColorStr and lShaded are optional 
  38.         parameters.  The function defaults to the current color and a 
  39.         shaded window.
  40.  
  41.  2)     Function RST_SWIN2() restores the last window region saved via a 
  42.         call to the function SAV_SWIN2().  The color setting prior to 
  43.         the last call to SAV_SWIN2() is also restored.
  44.  
  45.  3)     Function CLR_WIN() paints a box on the display according to the 
  46.         parameters.  The color is set to the color parameter passed; 
  47.         defaults to the current color.  The border is user definable as 
  48.         the cBorder parameter; defaults to a double-bar border.
  49.  
  50.  4)     Function DISPWIN() paints a box on the display according to the 
  51.         parameters.  The color is set to the color parameter passed; 
  52.         defaults to the current color.  The box has a double-bar 
  53.         horizontal borders with single-bar vertical borders.
  54.  
  55.  5)     Function SCR_DULLING() is part of Steven Straley's TooLkit (tm).
  56.         Function is supposed to set the dull the intensity attribute of 
  57.         the screen region passed as a parameter.  I have not tried this, 
  58.         but included it in my library of routines several months ago.
  59.  
  60.  6)     Function SCR_TO_TXT() theoretically parses the characters from 
  61.         the screen region passed down to the function.  Again, I have 
  62.         not tried this yet so I cannot ascertain the function operates 
  63.         correctly (it should work, however).  I wrote this function 
  64.         intending to use it as part of an error function to write user 
  65.         screens to disk for later retrieval (as part of an error logging 
  66.         system).
  67.  
  68.  
  69. Roderick Jay Cushman
  70.     4773 S. Breton Ct. S.E.  #213
  71.     Kentwood, MI  49508
  72.         (616) 554-9563
  73.  
  74.