home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / QBAS / WNDTOOL5.ZIP / README.DOC < prev    next >
Text File  |  1989-07-04  |  9KB  |  220 lines
  1.  
  2.                                                           July 4 , 1989
  3.  
  4.  
  5.                          BASIC WINDOWS TOOLS
  6.  
  7.                             version 5.0
  8.  
  9.                                 with
  10.  
  11.                           MS  Mouse support
  12.  
  13.  
  14.                                 BY
  15.  
  16.                          James P. Morgan
  17.                          5226 Via Hacienda #115
  18.                          Orlando Fl. 32809
  19.                          U.S.A.
  20.  
  21.  
  22.                   * based on original PD works by *
  23.  
  24.                              Dave Evers
  25.  
  26.  
  27.   ===========================================================================
  28.  
  29.    As an introduction, let me say that the modifications and enhancements
  30.   made by myself, James P Morgan, were based on the original source code
  31.   as distributed by Mr Evers. This source coded was greatly enhanced by myself
  32.   and released into the Public Domain, with Mr. Evers permission.
  33.  
  34.    This product, BASWIND5, is a MAJOR enhancement and as such will stand
  35.   on its own merits. BASWIND5 was designed to support ONLY QuickBASIC 4.5
  36.   from the command line compile, however limited testing has been done from
  37.   the environment, with no problems found as yet.
  38.  
  39.    Also,  assembler mouse interface routines were written to provide
  40.   MS Mouse support. These routines (for now) were patterned after the
  41.   ADVBAS9A.ARC library of routines, available on most BBSs. My next goal
  42.   is to replicate MOST/ALL the asm routines in ADVBAS and some of the
  43.   other routines in Shareware/PD libraries and make them (source and all)
  44.   available.
  45.  
  46.    With version 5.0 of BASWIND the source, .bas and .asm , is included as
  47.   well as a compiled QB4.5 version of the demo programs. The documentation
  48.   on how to interface to the various window/mouse routines is also included.
  49.   QB 2.0 and QB 3.0 will not be supported.
  50.  
  51.    I hate to re-invent the wheel, but if we can put together a library of
  52.   public domain QB routines and .asm routines to match ADVBAS and GLIB and
  53.   others, then we can all benefit.
  54.  
  55.  
  56.  
  57.  
  58.    YOUR FEEDBACK IS NECESSARY IF YOU USE BASWIND5 AND WANT THIS EFFORT TO
  59.    CONTINUE.
  60.  
  61.  
  62.        -  Version 5.00 is initially being distributed on
  63.                           ---------
  64.  
  65.                 1). THE PUBLIC (software) LIBRARY
  66.  
  67.                        P. O. Box 35705
  68.                        Houston TX  77235-5705
  69.  
  70.                        Ph :713-721-5205  - 713-721-6104
  71.  
  72.                     Ask for disk : (NOTE- has not been assign yet)
  73.  
  74.  
  75.                 2). PC ROCKLAND BBS - NY  (bulletin board, one of the BEST)
  76.  
  77.                      Download file : BASWIND5.ZIP
  78.  
  79.                        Ph :914-353-2538 (open public - non-subscribers)
  80.                                914-353-2157 (paid subscribers only)
  81.  
  82.  
  83.    Off the top of my head, some of the enhancements are:
  84.    -----------------------------------------------------
  85.  
  86.       o For BASWIND5 the MOST significant feature is support for MS Mouse
  87.        and mouse drivers that are compatible with the MS mouse driver.
  88.  
  89.       o Functions that now support a mouse STILL continue to support the key-
  90.         board. You can use the keyboard and mouse together or not. The mouse
  91.         DOES follow the keyboard cursor keys.
  92.  
  93.       o Window 'shadowing' now is TRUE shadowing. Any screen image that is
  94.        in a window shadow is NOT overwritten by a completely black character
  95.        BUT will be turned into a white-on-black character (as if the charac-
  96.        ter WERE in the shadow of another image).
  97.  
  98.       o All window modules will detect the calling "OPTION BASE" for arrays
  99.        and adjust all array handling routines accordingly .
  100.  
  101.       o The sub programs can be compiled separately and put into a
  102.        ".LIB" file for linking with separate standalone programs.
  103.  
  104.       o The sub programs can ALL be made into one large ".BAS" (windows.bas)
  105.        file.
  106.  
  107.       o Several bugs fixed, mainly the exploding windows bug and WAITTIME
  108.         midnite rollover.
  109.  
  110.       o Windows that 'grow' and windows with 'shadow' are no longer mutually
  111.         exclusive. You can have a window 'grow' with a shadow.
  112.  
  113.       o The options passed to most window functions can have leading spaces
  114.         (example : "  Calander") . This could allow for "nested" type menu
  115.         options displayed.
  116.  
  117.       o You can press the first letter of a MENU type option and the
  118.         cursor will JUMP immediately to next option which begins with
  119.         that character. The jump is circular, in other words the code
  120.         will look to the end of a array list and then start back at the front
  121.         and then back to the option the cursor was currently on.
  122.  
  123.       o A "QUESTION" function window was added. If your program requires
  124.         a "YES/NO" reply , the "QUESTION" window will handle that kind of
  125.         requirement.
  126.  
  127.       o The DEMO programs were modified to reflect and demonstrate the
  128.         the fixes and enhancements, to a better degree.
  129.  
  130.       o All variables in sub programs strong-typed, in other words each
  131.         variable should have "$%#!" ending character to fully define its
  132.         data type.
  133.  
  134.       o The Lotus 123 menu also supports "typing in of first character"
  135.         of option to select it (in addition to cursoring). Again the
  136.         "first letter" selection is a circular loop, in that all of the
  137.         options are checked, all the way back to the option that cursor
  138.         block is currently on.
  139.  
  140.       o Most all windows will accept a "first character" selection key
  141.        or still allow you to cursor to the option you want to select.
  142.  
  143.  
  144.  
  145.       o The source code "standardized" and structured for each sub program.
  146.  
  147.       o The SCROLL function was defined in the WINDTOOL documentation,
  148.         was omitted in the original.
  149.  
  150.       o The QUERY function was added. QUERY is a general purpose function
  151.         that serves as a template for such functions as WARNING/CAUTION.
  152.         WARNING/CAUTION/QUESTION were still included as separate functions
  153.         (for downward compatibility) even though they are now based on the
  154.         QUERY function (not standalone functions anymore).
  155.  
  156.       o The CALENDAR functions were all stardardized around a 'commom'
  157.         sub-program. The KEYCAL and CALENDR3 modules are no longer separate
  158.         programs , but use the CALENDAR sub-program for most of their work.
  159.  
  160.       o If you display a menu of items, you can pass the menu selection
  161.         you want to be the default (highlighted) when the menu initially
  162.         displayed.
  163.  
  164.       o When a menu has more items than are/can be displayed , the top and
  165.         bottom window frames will display 'arrows'. Clicking on the up or
  166.         down 'arrow' will page the window in that direction.
  167.  
  168.       o Menu windows that consist of more items than can be displayed
  169.         at once allow a Pageup/Pagedown to view the next window of selection
  170.         items. Such windows 'wrap' around now. If you are at the last menu
  171.         window, pressing Pagedown will display (wrap) the window menu of the
  172.         first group of item from which to select.
  173.  
  174.      o  When a menu window contains items from which you are to 'tag' some/
  175.         all/none for selection, you can pass the maximum number of items that
  176.         can be 'tagged' at one time.
  177.  
  178.  
  179.  
  180.  
  181.  
  182.      These efforts on my part represent better than 200+ hours , so please
  183.    understand that i am not trying to "steal" any of Mr Evers work. Mr. Evers
  184.    original works are still in the Public Domain, along with a prior enhanced
  185.    version that i released , with Mr. Evers permisssion.
  186.  
  187.      However , as with any software package, growth and evolution are nesess-
  188.    ary and in this case  MAJOR enhancements and re-write makes this BASWIND5,
  189.    a separate entity to stand on its own merits.
  190.  
  191.      The current source , written in QuickBASIC 4.5  and the assembler
  192.    routines, will be made available on request:
  193.  
  194.      Send a pre-paid mailer and formatted disk (4.25 or 3.5) to the address
  195.    below and allow 2-3 weeks for return mail. I have quite a few 'irons'
  196.    in the fire with other projects, so please understand. If you dont have
  197.    time or desire to put together a mailer, then send $10.00 and state type
  198.    of media you want the files returned on. For requests outside the conti-
  199.    nental U.S.A. please add an additional $5.00 (for a total of $15.00 US
  200.    funds ONLY). ONLY checks drawn on a US bank will be honored otherwise
  201.    the request cannot be processed.
  202.  
  203.      You will receive the QuickBASIC source and source to all the .asm
  204.    routines, FOR YOUR NON-COMMERCIAL USE ONLY and will be entered into
  205.    a database (if volume warrents) so you can be notified of any additions
  206.    and/or enhancemets to QB routines or the .asm routine library.
  207.  
  208.         ******   (allow 2-3 weeks to receive the disks)   ********
  209.  
  210.     MAIL TO:
  211.  
  212.              James P. Morgan
  213.              5226 Via Hacienda #115
  214.              Orlando FL, 32809
  215.              U.S.A.
  216.  
  217.      and please give your complete return mailing address.
  218.  
  219.   ======================== end of readme.doc (JP)===========================
  220.