Stars of Shareware: Programmierung

home *** CD-ROM | disk | FTP | other *** search

/ Stars of Shareware: Programmierung / SOURCE.mdf / programm / msdos / basic / pwez61 / update.doc < prev next >

Wrap

Text File | 1993-06-01 | 18.7 KB | 361 lines

Update Information ( Versions 5.00 / 5.10 / 6.00 / 6.10 ) The following routines were changed or added in version 6.00. These will require changes in programs written in versions 5.10 and 5.00. ( *6.10 = refers to version 6.10 only ) Use the new DECLARE.INC file as an include file in all modules in programs written in earlier versions to assure compatibility. - Text modes 80 x 25, 80 x 43, and 80 x 50 are supported in Ver. 6.00. Text mode 40 x 25 is no longer supported. - Event trapping is permissible in Ver 6.00. See WIND_REZ.DOC for details. - (*6.10) All previous versions used BASIC's floating point math routines. This generated over 11,000 bytes of extra program code for even the smallest of programs. All reference to any of BASIC's arithmetic operations or BASIC's statements using BASIC's floating point math routines has now been removed from WINDOWS R-E-Z. This allows executable's to be over 11,000 bytes smaller provided THE APPLICATION PROGRAM DOES NOT USE ANY OF BASIC's ARITHMETIC OPERATORS ( EX: ^ / ) OR STATEMENTS ( EX: VAL, SOUND ). Routine Changes ------- ------------------------------------------------- PULLDOWN May now be optionally exited if the MOUSE is (*6.10) pressed outside of the menubar or active pulldown window. May now be used in a "loop" mode waiting for the ALT key to be pressed. The ability to use as in previous versions has been retained. KEYMOUSE% This function has been replaced by individual keyboard ( GETAKEY% ) and mouse functions. SETSCRL This routine has been eliminated. The scroll arrow on the right border scroll windows has been replaced with scroll bars set by routine SCRLWIND. The argument for the "TAG" designator has been moved to routine B4SCRL. The argument for no-high intensity characters has been moved to routine SETWIND as it now affects several routines, B4SCRL Two arguments have been added to this routine. One represents the color of the "TAG" designator for mark scroll windows. The other allows scroll windows to be re-entered without refreshing same. SCRLWIND Two arguments have been added. One allows vertical and horizontal scroll bars. The other allows < OK > and < CANCEL > buttons. INPTINIT One argument, EXIT$, has been moved to a new routine, B4INPT. Three new arguments allow input fields in routines INPTWIND and MULTINPT to be entered with the cursor in position one or after the last character in the field. The second new argument allows a choice to blank an input field when the first valid character and display the character or to add the character to existing text in the field. The third argument allows the default sound to be generated when an invalid character is pressed. B4INPT NEW. This routine sets "exit keys" and restrict characters for a subsequent call to INPTWIND. INPTWIND Separate arguments now designate field and window colors. An argument has been added which allows the use of < OK > and < CANCEL > buttons. Real numbers have been included as a field choice. The argument for routine RESTRICT$ has been moved to routine B4INPT. SETINPT This routine is no longer used to make individual fields for routine MULTINPT. It is now used to set a MULTINPT screen number, display length, "exit keys" and field "hot character" colors. As all screens must be 80 column width the argument for display width ( COLWID% ) has been eliminated. MAKEFIELD NEW. This routine makes individual field for routine MULTINPT. Real number fields, "mouse only selectable", and button fields now are available. Fields may have different active, inactive, and "mouse active" colors. Fields may have "exit-to" characters, and a differently colored which may be a different color than the other characters. Fields are either AUTO-EXIT or not AUTO-EXIT. The AUTO-EXIT ON CHANGE field has been eliminated. UPDATEFIELD NEW. This routine can be used to update an individual field. MULTINPT The argument representing the "from field", on exit, always point to the "from field" regardless of the exit circumstances. A new argument has been added to designate exit via a "mouse only selectable" field. AUTO-EXIT ON CHANGE fields are no longer supported. EXEPATH$ NEW. Returns the path of the executable program. (*6.10) Only useful after a program is compiled and linked into an "executable". TWOPOWEROF& NEW. Returns a long integer representing two (*6.10) to the "nth" power. Used to replace BASIC's ^ operator with an mantissa of two. This prevents the inclusion of BASIC's floating point math routines in a program. WVAL& NEW. Returns a long integer representing the (*6.10) value of a numeric string. Used to replace BASIC's VAL function. This prevents the inclusion of BASIC's floating point math routines in a program. WTIMER& NEW. Returns a long integer holding the value of (*6.10) the systems 1/18th second timer. Can be used to simulate BASIC's SLEEP statement for periods less than a second. PRINTMENUBAR NEW. Prints the pulldown menubar. Useful if the (*6.10) ALT key will be used to enter routine PULLDOWN. SEE ROUTINE PULLDOWN. SCROLLPRINT NEW. Allows a subsequent call to routine SCRLWIND (*6.10) to print the scroll window's present selection at any screen location. GETAKEY% NEW. Returns a value for the key pressed or zero if no key has been pressed. Replaces KEYMOUSE%. CLEARKB NEW. Clears the type ahead keyboard buffer. CHOICEWIND% NEW. Displays a text filled window with up to ten choices. CHOICEBAR% NEW. Displays a choice bar with up to ten choices. GETANS A new argument allows for a different field and window colors. BOXW NEW. Draws a box in the active window. PRINTWHOT NEW. Prints text with a "hot character" in the active window. MOUSEINMULT% NEW. Returns a value if the mouse cursor occupies a field for a specified MULTINPT screen. MOUSEINWIND% NEW. Returns a value if the mouse cursor is in a specified window. *6.10 -- Earlier releases of version 6.00 did not allow the use of this function in window number zero. This is permitted in version 6.10. LBUTTON% NEW. Returns a value if the left mouse button is pressed. RBUTTON% NEW. Returns a value if the right mouse button is pressed. MOUSEROW% NEW. Returns the mouse cursor display row. MOUSECOL% NEW. Returns the mouse cursor display column. MOUSELIMIT NEW. Sets limits for mouse cursor movement. MOUSEPOS NEW. Returns the mouse cursor row and column position. MOUSEON% Now a function which attempts to turn the mouse on and returns a value if successful. MOUSEHIDE NEW. Hides the mouse cursor. MOUSESHOW NEW. Displays a previously hidden mouse cursor. GETDISK% Now a function which returns the default drive. Formally a sub-routine. FINDPATH$ Now a function which returns the default path. Formally a sub-routine. *6.10 --- Changed to always have the path returned with a "\" as the last character in the path. ( EX: C:\ C:\DOS\. ) This provides consistency with function EXEPATH$ which is new to Ver. 6.10. PEEKASM& NEW. Returns a value in a designated memory location. DISPLAYROWS% NEW. Return the number of active display rows. GETCUR& NEW. Returns a value representing the system cursor position and size. CUROFF NEW. Turns the system cursor off. SETCUR NEW. Restores the system cursor size and position. --------------------------------------------------------------- The following routines were changed or added in version 5.00 and version 5.10. These will require changes in programs written in version 4.20. ( *5.10 = Applies to changes in version 5.10 only.) NOTE: One of the major changes involves the active pulldown and active input window concept. For compatibility with previous versions of WINDOWS R-E-Z call new routine RSTRPULL on exit from routine PULLDOWN and call new routine RSTRINPT on exit from routine INPTWIND. Calls to these routines deactivate the active pulldown and input windows therefore simulating performance in earlier versions. The increased flexibility provided by active pulldown and input windows, however, is eliminated. Routine Changes -------- ------------------------------------------------- SETWIND Several arguments have been eliminated and are now defined by routine INPTINIT. *5.10 -- Several arguments have been eliminated and are now defined by routine SETSCRL. INPTINIT NEW. This routine sets the date format and the decimal designator. It also defines the "exit keys" for routine INPTWIND. THIS ROUTINE MUST BE CALLED ONCE BEFORE USING THE INPUT ROUTINES. SETPULL The format of the array holding the data for the pulldown windows has changed. The argument defining the menubar has been eliminated. PULLDOWN A new argument, an array holding the info-line data, has been added. The pulldown window on exit is now considered the active pulldown window. It remains displayed on exit. The active pulldown window may be re- entered as long as it remains active. A new argument suppressing exit on ESC has been added. ( replaced in version 5.10 ). *5.10 -- A new argument permits definable "exit keys". It replaces the argument added in version 5.00 which suppressed exit on the ESC key. *5.10 -- A new argument which returns the "exit key" has been added. RSTRPULL NEW. This routine can be used to restore the display area under, and deactivate the active pulldown window. SETSCRL NEW. Turns the position arrow on the right border (*5.10) of scroll windows "ON" or "OFF". Determines how pulldown and scroll windows display high intensity characters. Both of these features were previously included in routine SETWIND. This routine also sets the color for the arrow designating "marked" entries in marked scroll windows. If this routine is not called the position arrow defaults to "OFF". High intensity characters are displayed normally and the arrow designating marked entries assumes the same color as the text. B4SCRL NEW. This new routine permits definable "exit (*5.10) keys" for a single subsequent call to SCRLWIND. It also allows marked ( tagged ) entries to be set for a single subsequent call to routine SCRLWIND. SCRLWIND A new argument, an array holding the info-line data, has been added. A new argument defining the title for virtual scroll windows has been added. A new argument which represents the key pressed to exit the routine has been added. This argument may be used to determine the key which caused SCRLWIND to exit. "Virtual" scroll windows are a new feature, The argument defining the "key character" color has the added responsibility of allowing virtual scroll windows. "List" scroll windows are a new feature. *5.10 -- A new argument sets the row to be occupied by the scroll bar on entry and returns the row occupied by the scroll bar on exit. *5.10 -- A new argument sets the column position for characters on entry and returns same. ( for virtual scroll windows ) *5.10 -- A new feature allowing "extendable" scroll windows has been added. Extendable scroll windows allow scrolling through random access, ISAM, BTRIEVE, or other large data files. INPTWIND The values for the argument which represents the key pressed to exit the routine have changed to provide consistency with other routines. On exit the input window remains displayed and becomes the active input window. The active input window may be re-entered as long as it remains active. Several exit keys, as defined in new routine INPTINIT may now exit INPTWIND. RSTRINPT NEW. This routine is used to restore the display area occupied by the active input window generated by routine INPTWIND. This routine also deactivates the active input window. MULTINPT All possibilities for exit are resolved by one argument. Previous versions used argument EXIT$. Using this argument is no longer necessary or possible. Argument RKEY% now has this respons- ibility. It provides consistency with routines INPTWIND and SCRLWIND for the values representing the "exit keys." FINDPATH The path found is returned in the DOS format. FINDDIR The path for the directory search must be in the DOS format. GETANS This routine may now display the character (*5.10) representing the key pressed and wait for ENTER to finalize the selection. It may be used as in previous versions also. The argument representing the key pressed on exit is now used to determine the mode of operation on entry. To use as in previous versions this argument must = "" on entry. INFOLINE NEW. This routine sets the coordinates for, and saves the display area to be used by the info- line. The info-line is new in version 5.00. It is used to display instructions, prompts or information any place on the display. PRINTINFO NEW. This routine prints text in the info-line defined in a previous call to routine INFOLINE. INFOFIXED NEW. This routine defines a fixed string which prints in the info-line for every call to routine PRINTINFO. The text specified in routine PRINTINFO is appended to the fixed string defined by this routine. WAVAIL% NEW. This function can provide window status for all windows including pulldown and input windows. It also provides the status of the pulldown menubar and the info-line.