home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 14 / CDACTUAL.iso / cdactual / demobin / share / program / Basic / VWEZ60.ZIP / UPDATE.DOC < prev    next >
Encoding:
Text File  |  1992-11-11  |  15.7 KB  |  307 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                Update Information  ( Versions 5.00 / 5.10 / 6.00 )
  7.  
  8.           The following routines were changed or added in version 6.00.
  9.           These will require changes in programs written in versions 5.10
  10.           and 5.00
  11.  
  12.           Use the new DECLARE.INC file as an include file in all modules
  13.           in programs written in earlier versions to assure compatibility.
  14.  
  15.           - Text modes 80 x 25, 80 x 43, and 80 x 50 are supported in
  16.             Ver. 6.00.  Text mode 40 x 25 is no longer supported.
  17.  
  18.           - Event trapping is permissible in Ver 6.00.  See WIND_REZ.DOC
  19.             for details.
  20.  
  21.           Routine       Changes
  22.           -------       -------------------------------------------------
  23.  
  24.           KEYMOUSE%     This function has been replaced by individual
  25.                         keyboard ( GETAKEY% ) and mouse functions.
  26.  
  27.           SETSCRL       This routine has been eliminated.  The scroll
  28.                         arrow on the right border scroll windows has been
  29.                         replaced with scroll bars set by routine SCRLWIND.
  30.                         The argument for the "TAG" designator has been
  31.                         moved to routine B4SCRL.  The argument for no-high
  32.                         intensity characters has been moved to routine
  33.                         SETWIND as it now affects several routines,
  34.  
  35.           B4SCRL        Two arguments have been added to this routine.
  36.                         One represents the color of the "TAG" designator
  37.                         for mark scroll windows.  The other allows scroll
  38.                         windows to be re-entered without refreshing same.
  39.  
  40.           SCRLWIND      Two arguments have been added.  One allows
  41.                         vertical and horizontal scroll bars.  The other
  42.                         allows < OK > and < CANCEL > buttons.
  43.  
  44.           INPTINIT      One argument, EXIT$, has been moved to a new
  45.                         routine, B4INPT.  Three new arguments allow input
  46.                         fields in routines INPTWIND and MULTINPT to be
  47.                         entered with the cursor in position one or after
  48.                         the last character in the field.  The second new
  49.                         argument allows a choice to blank an input field
  50.                         when the first valid character and display the
  51.                         character or to add the character to existing
  52.                         text in the field.  The third argument allows the
  53.                         default sound to be generated when an invalid
  54.                         character is pressed.
  55.  
  56.           B4INPT        NEW.  This routine sets "exit keys" and restrict
  57.                         characters for a subsequent call to INPTWIND.
  58.  
  59.           INPTWIND      Separate arguments now designate field and window
  60.                         colors.  An argument has been added which allows
  61.                         the use of < OK > and < CANCEL > buttons.  Real
  62.                         numbers have been included as a field choice. The
  63.                         argument for routine RESTRICT$ has been moved to
  64.                         routine B4INPT.
  65.  
  66.           SETINPT       This routine is no longer used to make individual
  67.                         fields for routine MULTINPT.  It is now used to
  68.                         set a MULTINPT screen number, display length,
  69.                         "exit keys" and field "hot character" colors.  As
  70.                         all screens must be 80 column width the argument
  71.                         for display width ( COLWID% ) has been eliminated.
  72.  
  73.           MAKEFIELD     NEW.  This routine makes individual field for
  74.                         routine MULTINPT.  Real number fields, "mouse only
  75.                         selectable", and button fields now are available.
  76.                         Fields may have different active, inactive, and
  77.                         "mouse active" colors.  Fields may have "exit-to"
  78.                         characters, and a differently colored which may be
  79.                         a different color than the other characters.
  80.                         Fields are either AUTO-EXIT or not AUTO-EXIT.
  81.                         The AUTO-EXIT ON CHANGE field has been eliminated.
  82.  
  83.           UPDATEFIELD   NEW.  This routine can be used to update an
  84.                         individual field.
  85.  
  86.           MULTINPT      The argument representing the "from field", on
  87.                         exit, always point to the "from field" regardless
  88.                         of the exit circumstances.  A new argument has
  89.                         been added to designate exit via a "mouse only
  90.                         selectable" field.  AUTO-EXIT ON CHANGE fields
  91.                         are no longer supported.
  92.  
  93.           GETAKEY%      NEW.  Returns a value for the key pressed or zero
  94.                         if no key has been pressed.  Replaces KEYMOUSE%.
  95.  
  96.           CLEARKB       NEW.  Clears the type ahead keyboard buffer.
  97.  
  98.           CHOICEWIND%   NEW.  Displays a text filled window with up to
  99.                         ten choices.
  100.  
  101.           CHOICEBAR%    NEW.  Displays a choice bar with up to ten
  102.                         choices.
  103.  
  104.           GETANS        A new argument allows for a different field and
  105.                         window  colors.
  106.  
  107.           BOXW          NEW.  Draws a box in the active window.
  108.  
  109.           PRINTWHOT     NEW.  Prints text with a "hot character" in the
  110.                         active window.
  111.  
  112.           MOUSEINMULT%  NEW.  Returns a value if the mouse cursor occupies
  113.                         a field for a specified MULTINPT screen.
  114.  
  115.           MOUSEINWIND%  NEW.  Returns a value if the mouse cursor is in a
  116.                         specified window.
  117.  
  118.           LBUTTON%      NEW.  Returns a value if the left mouse button is
  119.                         pressed.
  120.  
  121.           RBUTTON%      NEW.  Returns a value if the right mouse button is
  122.                         pressed.
  123.  
  124.           MOUSEROW%     NEW.  Returns the mouse cursor display row.
  125.  
  126.           MOUSECOL%     NEW.  Returns the mouse cursor display column.
  127.  
  128.           MOUSELIMIT    NEW.  Sets limits for mouse cursor movement.
  129.  
  130.           MOUSEPOS      NEW.  Returns the mouse cursor row and column
  131.                         position.
  132.  
  133.           MOUSEON%      Now a function which attempts to turn the mouse on
  134.                         and returns a value if successful.
  135.  
  136.           MOUSEHIDE     NEW.  Hides the mouse cursor.
  137.  
  138.           MOUSESHOW     NEW.  Displays a previously hidden mouse cursor.
  139.  
  140.           GETDISK%      Now a function which returns the default drive.
  141.                         Formally a sub-routine.
  142.  
  143.           FINDPATH$     Now a function which returns the default path.
  144.                         Formally a sub-routine.
  145.  
  146.           PEEKASM&      NEW.  Returns a value in a designated memory
  147.                         location.
  148.  
  149.           DISPLAYROWS%  NEW.  Return the number of active display rows.
  150.  
  151.           GETCUR&       NEW.  Returns a value representing the system
  152.                         cursor position and size.
  153.  
  154.           CUROFF        NEW.  Turns the system cursor off.
  155.  
  156.           SETCUR        NEW.  Restores the system cursor size and position.
  157.  
  158.  
  159.           ---------------------------------------------------------------
  160.           The following routines were changed or added in version 5.00 and
  161.           version 5.10.  These will require changes in programs written in
  162.           version 4.20. ( *5.10 = Applies to changes in version 5.10 only.)
  163.  
  164.           NOTE: One of the major changes involves the active pulldown
  165.           and active input window concept.  For compatibility with
  166.           previous versions of WINDOWS R-E-Z call new routine RSTRPULL
  167.           on exit from routine PULLDOWN and call new routine RSTRINPT
  168.           on exit from routine INPTWIND.  Calls to these routines
  169.           deactivate the active pulldown and input windows therefore
  170.           simulating performance in earlier versions.  The increased
  171.           flexibility provided by active pulldown and input windows,
  172.           however, is eliminated.
  173.  
  174.  
  175.           Routine       Changes
  176.           --------      -------------------------------------------------
  177.           SETWIND       Several arguments have been eliminated and are
  178.                         now defined by routine INPTINIT.
  179.              *5.10 --   Several arguments have been eliminated and are
  180.                         now defined by routine SETSCRL.
  181.  
  182.           INPTINIT      NEW. This routine sets the date format and the
  183.                         decimal designator.  It also defines the "exit
  184.                         keys" for routine INPTWIND.  THIS ROUTINE MUST BE
  185.                         CALLED ONCE BEFORE USING THE INPUT ROUTINES.
  186.  
  187.           SETPULL       The format of the array holding the data for
  188.                         the pulldown windows has changed.
  189.                         The argument defining the menubar has been
  190.                         eliminated.
  191.  
  192.           PULLDOWN      A new argument, an array holding the info-line
  193.                         data, has been added.
  194.                         The pulldown window on exit is now considered
  195.                         the active pulldown window.  It remains displayed
  196.                         on exit.  The active pulldown window may be re-
  197.                         entered as long as it remains active.
  198.                         A new argument suppressing exit on ESC has been
  199.                         added. ( replaced in version 5.10 ).
  200.              *5.10 --   A new argument permits definable "exit keys".
  201.                         It replaces the argument added in version 5.00
  202.                         which suppressed exit on the ESC key.
  203.              *5.10 --   A new argument which returns the "exit key" has
  204.                         been added.
  205.  
  206.           RSTRPULL      NEW.  This routine can be used to restore the
  207.                         display area under, and deactivate the active
  208.                         pulldown window.
  209.  
  210.           SETSCRL       NEW.  Turns the position arrow on the right border
  211.           (*5.10)       of scroll windows "ON" or "OFF".  Determines how
  212.                         pulldown and scroll windows display high intensity
  213.                         characters.  Both of these features were previously
  214.                         included in routine SETWIND.  This routine also sets
  215.                         the color for the arrow designating "marked"
  216.                         entries in marked scroll windows.  If this routine
  217.                         is not called the position arrow defaults to "OFF".
  218.                         High intensity characters are displayed normally
  219.                         and the arrow designating marked entries assumes the
  220.                         same color as the text.
  221.  
  222.           B4SCRL        NEW.  This new routine permits definable "exit
  223.           (*5.10)       keys" for a single subsequent call to SCRLWIND.  It
  224.                         also allows marked ( tagged ) entries to be set for
  225.                         a single subsequent call to routine SCRLWIND.
  226.  
  227.           SCRLWIND      A new argument, an array holding the info-line
  228.                         data, has been added.
  229.                         A new argument defining the title for virtual
  230.                         scroll windows has been added.
  231.                         A new argument which represents the key pressed
  232.                         to exit the routine has been added.  This argument
  233.                         may be used to determine the key which caused
  234.                         SCRLWIND to exit.
  235.                         "Virtual" scroll windows are a new feature,
  236.                         The argument defining the "key character" color
  237.                         has the added responsibility of allowing virtual
  238.                         scroll windows.
  239.                         "List" scroll windows are a new feature.
  240.              *5.10  --  A new argument sets the row to be occupied by the
  241.                         scroll bar on entry and returns the row occupied by
  242.                         the scroll bar on exit.
  243.              *5.10  --  A new argument sets the column position for
  244.                         characters on entry and returns same. ( for virtual
  245.                         scroll windows )
  246.              *5.10  --  A new feature allowing "extendable" scroll windows
  247.                         has been added.  Extendable scroll windows allow
  248.                         scrolling through random access, ISAM, BTRIEVE, or
  249.                         other large data files.
  250.  
  251.           INPTWIND      The values for the argument which represents the
  252.                         key pressed to exit the routine have changed to
  253.                         provide consistency with other routines.
  254.                         On exit the input window remains displayed and
  255.                         becomes the active input window.  The active
  256.                         input window may be re-entered as long as it
  257.                         remains active.
  258.                         Several exit keys, as defined in new routine
  259.                         INPTINIT may now exit INPTWIND.
  260.  
  261.           RSTRINPT      NEW. This routine is used to restore the display
  262.                         area occupied by the active input window
  263.                         generated by routine INPTWIND.  This routine
  264.                         also deactivates the active input window.
  265.  
  266.           MULTINPT      All possibilities for exit are resolved by one
  267.                         argument.  Previous versions used argument EXIT$.
  268.                         Using this argument is no longer necessary or
  269.                         possible.  Argument RKEY% now has this respons-
  270.                         ibility. It provides consistency with routines
  271.                         INPTWIND and SCRLWIND for the values representing
  272.                         the "exit keys."
  273.  
  274.           FINDPATH      The path found is returned in the DOS format.
  275.  
  276.           FINDDIR       The path for the directory search must be in
  277.                         the DOS format.
  278.  
  279.           GETANS        This routine may now display the character
  280.           (*5.10)       representing the key pressed and wait for ENTER to
  281.                         finalize the selection.  It may be used as in
  282.                         previous versions also.
  283.                         The argument representing the key pressed on exit
  284.                         is now used to determine the mode of operation on
  285.                         entry.  To use as in previous versions this
  286.                         argument must = "" on entry.
  287.  
  288.           INFOLINE      NEW. This routine sets the coordinates for, and
  289.                         saves the display area to be used by the info-
  290.                         line.  The info-line is new in version 5.00.  It
  291.                         is used to display instructions, prompts or
  292.                         information any place on the display.
  293.  
  294.           PRINTINFO     NEW. This routine prints text in the info-line
  295.                         defined in a previous call to routine INFOLINE.
  296.  
  297.           INFOFIXED     NEW. This routine defines a fixed string which
  298.                         prints in the info-line for every call to
  299.                         routine PRINTINFO.  The text specified in routine
  300.                         PRINTINFO is appended to the fixed string defined
  301.                         by this routine.
  302.  
  303.           WAVAIL        NEW. This function can provide window status for
  304.                         all windows including pulldown and input windows.
  305.                         It also provides the status of the pulldown menubar
  306.                         and the info-line.
  307.