home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / turbopas / window34.arc / WINDOW34.DOC < prev    next >
Encoding:
Text File  |  1987-08-31  |  7.3 KB  |  173 lines
  1.                                                            August 31, 1987
  2.  
  3.                                MULTI-LEVEL WINDOWS
  4.                                    Version 3.4
  5.  
  6.         PURPOSE:
  7.  
  8.         These procedures create incredibly quick multi-level windows as
  9.         include files in Turbo Pascal programs for all IBM and compati-
  10.         bles including the new PS/2 systems.  They work in all text modes 
  11.         and any column mode (40/80/etc.) using the quick screen writing 
  12.         procedures of QWIK30.INC.  
  13.  
  14.  
  15.         TEST DRIVE:
  16.  
  17.         Compile and run the tutoring program WTUTOR34.PAS to get a feeling
  18.         for features and speed.
  19.  
  20.  
  21.         FILES:
  22.  
  23.         In this version, WINDOW34.ARC contains:
  24.  
  25.            !_read  .me!:  File that insists you get a copy of QWIK30.ARC.
  26.            Qwik30  .inc:  Include file for quick screen writing.
  27.            Window34.inc:  Include file for your programs to use windows.
  28.            Wtutor34.pas:  Demo of Window34.inc and Qwik30.inc which also
  29.                           gives a tutorial of user instructions.
  30.            Window34.doc:  This document.
  31.            ScrollBi.pas:  Alternate BIOS scroll for ScrollWindow.
  32.            License .arc:  ARC file containing license agreements
  33.  
  34.  
  35.         IMPROVEMENTS:
  36.  
  37.         The new QWIK30.INC procedures have been included.  A new control 
  38.         was added - FixedWindow.  When setting up your first windows on 
  39.         the screen that are intended to be permanent, use FixedWindow to 
  40.         keep them in place and not store unnecessary data on the heap.  
  41.         Most other changes were done to optimize code using pred and succ 
  42.         where possible.  
  43.  
  44.         This version is fully compatible with version 3.3.
  45.  
  46.  
  47.         SHAREWARE:
  48.  
  49.         Due to the lack of participation and expense, I have decided to 
  50.         abandon the Teamware concept and instead make them into ShareWare.  
  51.         The cost may range from $4 to $25 depending on your application.  
  52.         I do enjoy assisting others in their programming, but lack of 
  53.         reimbursement is expensive for me!  Please help out.  See the 
  54.         STATMENT.LIC in LICENSE.ARC for details.  If the response will let 
  55.         me break even, I will continue support.
  56.  
  57.  
  58.         ADDITIONAL NOTES:
  59.  
  60.         The WTUTOR34.PAS covers most of the instructions for use, but 
  61.         users should also read QWIK30.DOC to get the most of these 
  62.         procedures.  For instance, WINDOW34.INC can work on up to 8 
  63.         display pages depending on your video card.  Turbo Pascal 
  64.         procedures only work on the first page, page 0.  This is where Q 
  65.         screen procedures come in.  They will work on any page.  Even 
  66.         though WINDOW34.INC will seem to make a Turbo Window on say page 
  67.         3, the standard procedures of WriteLn, Window, GotoXY, etc. will 
  68.         not work there.  You must then use Q screen procedures for those 
  69.         pages.
  70.  
  71.         There may be later versions of QWIK.INC, so use the latest one.
  72.  
  73.         Remember that a Turbo window cannot have less than 2 rows or 
  74.         columns and still work scrolling and wrap-around.
  75.  
  76.         FixedWindow - Set the FixedWindow boolean flag to true prior to 
  77.         MakeWindow after which MakeWindow sets it back to false.  Then 
  78.         MakeWindow will not save the screen in the heap and disables 
  79.         RemoveWindow from trying to restore it.  This is useful when you 
  80.         first set up a display design with several windows where there is 
  81.         no need to save any screen contents.  There is no demonstration of 
  82.         FixedWindow.
  83.  
  84.         Hatch Borders - With the 9x16 character cell size on the new VGA 
  85.         adapters, the hatch characters (ASCII 176, 177, 178) are only 8x16 
  86.         in a 9x16 cell.  This unfortunately produces a horizontal gap 
  87.         between the characters not seen on the CGA.  Be aware of the 
  88.         effect.
  89.  
  90.         Full Screen Windows - Be sure ShadowEffect is set to NoDir when 
  91.         making a full screen window.  Otherwise, the shadow will wrap 
  92.         around to the other side of the screen leaving a black column.
  93.  
  94.         Pull-down Menus - An application of windows is multi-level pull-
  95.         down menus.  I have already created some very thorough code in a 
  96.         file called PULL15.ARC.  It is fully featured and fully 
  97.         configurable.  Includes execute, single, and multiple choice 
  98.         menus, unlimited nested submenus, data entry windows, help 
  99.         windows, message system, fully completed interfaces. 
  100.  
  101.         On-line source - All updated files can be found on the CompuServe 
  102.         Borland Forum (GO BORPRO) in the MSDOS Turbo Pascal Data Library.
  103.  
  104.  
  105.         LIABILITY:
  106.  
  107.         No liabilities are assumed in the use or misuse of these 
  108.         procedures.
  109.  
  110.  
  111.         CREDITS:
  112.  
  113.         The initial program was developed by Michael Burton in his copy
  114.         of WINDO.INC, ver 2.4.  The program was edited by permission and
  115.         re-released as WINDOW30.ARC.
  116.  
  117.         Copyright (c) 1986,1987 by James H. LeMay, Michael Burton
  118.         Even though this is source code, it is still protected by the 
  119.         United States Copyright Law.
  120.  
  121.         Current author:
  122.           Jim LeMay, 6341 Klamath Rd., Ft. Worth, TX  76116
  123.             1-(817) 732-7150 (after 1730 PST), CIS 76011,217
  124.         Initial author:
  125.           Michael Burton, 15540 Boot Hill Rd., Hayden Lake, ID 83835
  126.             1-(208)-772-9347 (after 1800 PST)
  127.  
  128.         Special effects concepts were graciously suggested by:
  129.  
  130.           Rick Fothergill, 141 Oak Hill Road, Pittsfield, MA 01201
  131.             Data: 1-(413)-499-7245, CIS 76210,443
  132.             GEnie Mail:  R.FOTHERGILL
  133.  
  134.  
  135.         REVISIONS:
  136.  
  137.         Version 3.0 (01-01-87):
  138.           . Incorporated QWIK21.INC for improved performance,
  139.             compatibility, and reduction of code.
  140.           . Released under the teamware concept.
  141.  
  142.         Version 3.1 (02-11-87):
  143.           . Added zoom and shadow effects.
  144.           . Added attribute function.
  145.           . Added justification for window title.
  146.           . Combined foreground and background parameters into one
  147.             attribute.
  148.           . Deleted Bleep procedure.
  149.           . Modified border constants and added BlankBrdr and UserBrdr.
  150.           . Made Qbox skip border for NoBrdr.
  151.           . Made MaxWndw responsibility of the user.
  152.  
  153.        Version 3.2 (02-20-87):
  154.           . Corrected bug in zoom effect that caused infinite loop
  155.             on windows with a row/col < 4.
  156.           . Added ScrollWindow (Suggested by Art Hill).
  157.  
  158.         Version 3.3 (04-08-87):
  159.           . Added global HeapOK function to check heap space.
  160.           . Used heap instead of stack for ScrollWindow.
  161.           . Provided optional code for BIOS scroll.
  162.           . Streamlined the code in MakeWindow and RemoveWindow.
  163.           . Changed GotoXY to GotoRC to work on video page 1 and up.
  164.           . Added LIcurrent to keep track of current window.
  165.           . Revised WTUTOR33 to allow back up.
  166.           . Revised WTUTOR33 to easily move window with contents.
  167.  
  168.         Version 3.4 (08-31-87):
  169.           . Incorporated QWIK30.INC for full IBM compatibility.
  170.           . Optimized code with pred and succ functions.
  171.           . Added FixedWindow function.
  172.           . Released as Shareware.
  173.