Stars of Shareware: Programmierung

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

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

Wrap

Text File | 1993-06-01 | 32.4 KB | 1,057 lines

Quick Reference Guide For use with WINDOWS R-E-Z QuickBasic 4.5 and BASIC 7.1 (PDS) Visual BASIC for DOS 1.00 Version 6.10 Copyright (c) 1988 - 1993 by: CONNECT Software All rights reserved ( See WIND_REZ.DOC for details. ) ( All routines are sub-routines unless noted otherwise. ) ===================================================================== Window Management System ===================================================================== BOXW ( ROW%, COL%, WID%, NR%, BORDER% ) Prints a box in the active window. ROW% is the row position in the active window for the top row of the box. COL% is the column position in the active window for the left border of the box. WID% is the width of the box. NR% is the number of rows in the box. BORDER% = 1, 2 or 0 for a single, double line or no border. -------------------------------------------------------------------- CHNGWIND (W%) Changes the active window to a new window. W% is the new active window number. ( 1 to 20 ) -------------------------------------------------------------------- CLRWIND Clears the interior of the active window. -------------------------------------------------------------------- DELWIND (W%) Deletes a saved window from window memory. W% is the window number to delete. ( 1 to 20 ) -------------------------------------------------------------------- LINEW (ROW%, TYP%) Prints, or erases, a horizontal line in the active window. ROW% is the row in the window in which the line will print. TYP% = 1 for single line, 2 for double line, 0 to erase a line. -------------------------------------------------------------------- MAKEWIND (W%, TITLE$, TR%, LC%, WD%, NR%, ATTR%, BORD%) Makes a window and optionally saves a windowed area. W% is the assigned window number. ( 0 to 20 ) "0" is not saved. TITLE$ is the window's title. TR% is the window's top row. ( 1 to display rows or 100 ) LC% is the window's left column. ( 1 to 78 or 100 ) WD% is the window's width. ( 3 to 80 ) NR% is the number of rows. ( 3 to display rows ) ATTR% is the window's color designation. ( 0 to 255 ) BORD% is the border designation. (0-2, 10-12, 20-22, 30-32, 40-42, 100-102, 110-112, 120-122, 130-132, 140-142 ) -------------------------------------------------------------------- 1 Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved. ===================================================================== Window Management System - Cont. ===================================================================== NEWCOLOR (ATTR%) Changes the "print-to" color of the active window. ATTR% is the new "print-to" color. ( 0 to 255 ) --------------------------------------------------------------------- PRINTW (TEXT$, ROW%, COL%) Prints text in the active window. TEXT$ is the text to print in the active window. ROW% is the row in the window in which the text will print. COL% is the column in the window where the text print starts . -------------------------------------------------------------------- PRINTWHOT (TEXT$, ROW%, COL%, CHAR%, ATTR%) Prints text in the active window - with a "hot character". TEXT$ is the text to print in the active window. ROW% is the row in the window in which the text will print. COL% is the column in the window where the text print starts . CHAR% is the position in TEXT$ of the "hot character". ATTR% is the color of the "hot character". --------------------------------------------------------------------- RESAVE Saves the active window and interior of same in window memory. Replaces the area covered by the active window in window memory. -------------------------------------------------------------------- RSTRWIND (W%, DELFLAG%) Restores a window from window memory to the display. W% is the window number to restore. ( 1 to 20 ) DELFLAG% = 1 to remove the window (W%) from window memory. 0 to leave the window (W%) in window memory. -------------------------------------------------------------------- SAVEWIND (W%, TR%, LC%, WD%, NR%) Saves an area from the display to window memory. W% is the window area's assigned number. ( 1 to 20 ) TR% is the top row. ( 1 to display rows or 100 ) LC% is the left column. ( 1 to 78 or 100 ) WD% is the width. ( 3 to 80 ) NR% is the number of rows. ( 3 to display rows ) --------------------------------------------------------------------- 2 Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved. ===================================================================== Window Management System - Cont. ===================================================================== SETWIND (FAST%, SND%, SHAD%, NOHI%, BRACKETATTR% ) Sets window memory, sound, and display update speed. FAST% = 1 for fast screen updates, 0 for slow CGA screen updates. SND% = 1 for "click", 2 for "beep", and 0 for no sound. SHAD% is the window shadow color. ( 0 to 255 ) NOHI% = 1 for no high intensity characters ( LCD displays ) = 0 for normal high intensity characters. BRACKETATTR% sets the bracket ( < > ) foreground color for buttons for INPTWIND, SCRLWIND, CHOICEWIND% and CHOICEBAR%. ( 0 to 15 ) -------------------------------------------------------------------- WAVAIL% (WINDOW%) *** FUNCTION *** Returns 1 if a window is available, 0 if it is not available. WINDOW% is the window number. ( 1 to 25 ) -------------------------------------------------------------------- WINDSTATUS Display the status of windows saved in window memory. -------------------------------------------------------------------- 3 Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved. ===================================================================== Pulldown Windows ===================================================================== CHNGPULL (BARITEM%, WINDITEM%, ATTR%) Makes a pulldown window selection active or inactive. BARITEM% is the number of the pulldown menu bar selection. WINDITEM% is the number of the pulldown window selection. = -1 to affect all pulldown window selections. ATTR% = 0 for active selection with original color. 1 to 127 for inactive selection with new color. -------------------------------------------------------------------- SETPULL (TR%, LC%, WD%, PWIND$() ) Set up routine for pulldown windows TR% is the top row of the menubar. ( 1 to display rows - 4 ) LC% is the left column position of the menubar. ( 1 to 73 ) WD% the menubar's width. ( Maximum of 81 - LC% ) PWIND$() is the array holding the data for the pulldown menubar, menubar's info-line, and pulldown window's selections. -------------------------------------------------------------------- PRINTMENUBAR ( ATTR% ) Prints the pulldown menu bar as specified in the call to SETPULL for the pulldown windows. Only required if the "ALT KEY" method is used to enter pulldown. ATTR% is the menubar's color. ( 1 to 127 ) -------------------------------------------------------------------- PULLDOWN (INFO$(),MENUBAR%,WINDITEM%,EXIT$,RKEY%,ATTR%,KEYATTR%,BRDR%) Places user in the pulldown window environment. INFO$() holds the pulldown window's selections info-line data. MENUBAR% is the selected menu bar item on exit. WINDITEM% is the selected pulldown window item. EXIT$ sets the exit keys. RKEY% represents the key pressed, which caused the exit. ATTR% is the color for the pulldown windows. ( 1 to 127 ) KEYATTR% is the color for the key characters. ( 1 to 127 ) BRDR% is the border designation. ( 0,1,2,10,11,12) -------------------------------------------------------------------- RSTRPULL ( RSTRMENUBAR% ) Deactivates the active pulldown window. Restores the display area under the active pulldown window, optionally restoring the area under the menubar also. RSTRMENUBAR% is set to 1 to restore the display area under the menubar, 0 does not restore the area. -------------------------------------------------------------------- 4 Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved. ===================================================================== Scroll Windows ===================================================================== B4SCRL ( EXIT$, MARK$, TAGCOL%, NOREFRESH% ) Provides additional options for a subsequent call to SCRLWIND. EXIT$ sets those keys or circumstances which will exit SCRLWIND. ( Any combination of "0123456789ERIDXTMOA" ) MARK$ allows selections in a scroll window to be marked on entry. TAGCOL% is the foreground color or the tag designator for "Mark" scroll windows. ( 0 to 15 ) NOREFRESH% = 1 to enter the scroll window without refreshing it's interior or 0 to refresh the interior. -------------------------------------------------------------------- SCRLWIND ( LIST$(), INFO$(), TL$, ENTRIES%, KIND$, RTRN%, LI%, FC%, RKEY%, KEYATTR%, SCROLLBAR%, BUTTON%) Note: The above call to SCRLWIND must be typed one line in the QB/QBX/VBDOS environment. Places a scrollable list in a window previously made by MAKEWIND. LIST$() is the list to place in the scroll window. INFO$() is the scroll window's selections info-line data. TL$ is the top line message for scroll windows with title boxes. ENTRIES% is the number of items in LIST$(). KIND$ sets the type of scroll windows on entry to SCRLWIND. "A"=autoexit "M"=multiple mark "S"=single mark "V","SV"=view/single-mark view "L"=list only Holds coded data for "mark" scroll windows on exit. RTRN% sets the highlighted selection on entry. On exit, it returns the sequential item selected from the scroll window. LI% sets the interior row position the selected entry will occupy on entry. On exit, it returns the row position occupied by the highlighted entry. FC% sets the offset from start of the strings ( entries ) to print in the first column of virtual scroll window. On exit, it returns the offset from the start of the strings ( entries ) occupying the first column in virtual scroll windows. KEYATTR% is the color for the key characters. ( 0 to 127 ) 0 = virtual scroll windows if any selections are wider the window's width minus 4. 1 to 127 = non-virtual scroll window SCROLLBAR% determines if scroll bars are used. 0 = no scroll bars. 1 = use scroll bars BUTTON% determines if < OK > < CANCEL > buttons are used. 0 = no buttons. 1 = < OK > button. 2 = < OK > and < CANCEL > buttons. --------------------------------------------------------------------- 5 Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved. ===================================================================== Scroll Windows - Cont. ===================================================================== MARKED% (RTRN$, START%) *** FUNCTION *** Decodes marked items from a "mark" scroll window. RTRN$ is the string representing items marked in a scroll window. START% is the position in which to start the decoding in RTRN$. --------------------------------------------------------------------- SCROLLPRINT ( ROW%, COLUMN%, ATTR% ) Allows a subsequent call to routine SCRLWIND to print it's selected item at any screen location. ROW% is the row position in which the selected item prints. COLUMN% is the column position the selected item starts printing. ATTR% is the color of the selected item's text. ( 1 to 255 ) --------------------------------------------------------------------- 6 Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved. ===================================================================== Input Routines ===================================================================== B4INPT ( EXIT$ ,RESTRICT$ ) Sets parameters for a subsequent call to INPTWIND. Only affects the next call to INPTWIND. EXIT$ sets the exit keys for routine INPTWIND and may equal any combination of "0123456789UDER". RESTRICT$ restricts input to user defined characters for a subsequent call to INPTWIND. --------------------------------------------------------------------- CHOICEBAR% ( C$(), ROW%, COL%, WD%, ATTR%, HATTR%, EX$ ) ** FUNCTION ** Displays a choice bar with up to 10 choices. C$() is an array holding the choices. ROW% is the choice bar's row position. COL% is the choice bar's left column position. WD% is the choice bar's width. ATTR% is the choice bar's color. HATTR% if the "hot character's" color. EX$ provide alternate exit keys. any combination of "0123456789UDETO" --------------------------------------------------------------------- CHOICEWIND% ( T$, TXT$(), CH$(), R%, C%, ATTR%, HATTR%, ESC%, BRDR% ) **FUNCTION** Display a text filled window with a choicebar. T$ is the choice window's title. TXT$() is an array holding the text. CH$() is an array holding the choices. R% is the choice window's top row position, C% is the choice window's left column position. ATTR% is the choice window's color. HATTR% is the color of the "hot character" in the choice window's choice bar. ESC% is set to 1 to allow ESC to exit or 0 to suppress ESC exit. BRDR% = choice window's border designation. SAME AS MAKEWIND. --------------------------------------------------------------------- 7 Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved. ===================================================================== Input Routines - Cont. ===================================================================== GETANS (PROMPT$, CHOICE$, ANS$, TR%, LC%, WATTR%, FATTR%, BRDR%) Displays a windowed prompt. Waits for a single key user response. PROMPT$ is the prompt to place in the get answer window. CHOICE$ represents the allowable keys GETANS will recognize. ANS$ sets the mode of operation for GETANS on entry. If ANS$ = "" on entry GETANS exits as soon as a valid key is pressed. If ANS$ equals any character the character is displayed on entry. ENTER must be pressed to exit. On exit, ANS$ returns the character (key) selected by the user. TR% is the top row of the get answer window. LC% is the left column of the get answer window. WATTR% is the color of the get answer window. ( 1 to 255 ) FATTR% is the color of the field. Only if ANS$ <> "". BRDR% is the border designation. (0-2, 10-12, 20-22, 30-32, 40-42, 100-102, 110-112, 120-122, 130-132, 140-142 ) --------------------------------------------------------------------- INPTINIT ( DATEFORMAT%, ISDOT%, AT1%, BLANK%, MAKESND%) Initializes input memory for routines INPTWIND an MULTINPT. Sets user preferences. DATEFORMAT% sets the allowable date format. ( 1 to 5 ) ISDOT% equals 1 for a period decimal point, 0 for a comma. AT1% determines the cursor position on entry to a field. 1 = position 1. 0 = end of text. BLANK% determines if the first valid character erases the field. 1 = erase on first character pressed. 0 = don't erase. MAKESND% equals 1 for sound on invalid character or 0 for no sound on invalid character. --------------------------------------------------------------------- INPTWIND (P$,CODE$,TR%,LC%,WD%,WATTR%,FATTR%,RTRN$,RKEY%,BUT%,BRDR%) Places an input window on the display. Waits for user input. P$ is the prompt displayed for the input window. CODE$ is the code for the type of allowable input. TR% is the top row. LC% is the left column. WD% is the width of the input field. WATTR% is the color for the input window. FATTR% is the color for the input field. RTRN$ is the text entered by the user in the input field. RKEY% represents the "exit key". 1 to 13, 27 BUT% equal the number of buttons. 0 = none. 1 = < OK >. 2 = < OK > and < CANCEL >. BRDR% is the border designation. (0-2, 10-12, 20-22, 30-32, 40-42, 100-102, 110-112, 120-122, 130-132, 140-142 ) --------------------------------------------------------------------- 8 Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved. ===================================================================== Input Routines - Cont. ===================================================================== MAKEFIELD (SCRN%, FLD%, CODE%, ROW%, COL%, WD%, BASEATTR%, ACTATTR%, MATTR%, RES$, EXTO$, HOTPOS%, CURPOS%, BRACKET% ) ** The above must be on one line in QB/QBX/VBDOS ** Makes an input field for a MULTINPT. SCRN% is the mult-field input screen. ( 1 to 10 ) FLD% is the field number. ( 1 to 150 ) CODE% is the field type. ROW% is the row position of the field. COL% is the left column position of the field. WD% is the field's width. BASEATTR% is the field's inactive color. ACTATTR% is the field's active color. MATTR% is the field's color while the mouse cursor occupies it and the left mouse button is pressed. RES$ restricts input to user defined characters. For an alpha/numeric field only. EXTO$ is a key, when pressed from a non-input type field, moves the system cursor to the field. HOTPOS% is the character position in a field which assumes the "hot color" set by routine SETINPT. CURPOS% is an alternate starting position for the cursor when a field is entered. BRACKET% equals 1 to make the first and last characters in a field equal the BRACKETATTR% set by routine SETWIND. Equals 0 for the normal text color. --------------------------------------------------------------------- MULTINPT (SCRN%, TOFLD%, CODE$, FROMFLD%, RKEY%, RTRN$() SEL% ) Displays input fields and waits for user entry. SCRN% is the assigned multi-field input screen to display. TOFLD% = the next active field when entering or exiting MULTINPT. CODE$ is set to "VIEW" for view only, "U" to change several field movement keys to follow user defined order. FROMFLD% sets single field update on entry. Holds the last active field when MULTINPT exits. RKEY% holds the designation for the key which exited MULTINPT. RTRN$() is the array holding each input field's data. SEL% holds a "mouse only selectable" field number if same cause MULTINPT's exit. --------------------------------------------------------------------- RSTRINPT ( RESTOREFLAG% ) Deactivates the active input window optionally restoring the display area under same. RESTOREFLAG% is set to 1 to restore the display area under the active input window, 0 to not restore it. --------------------------------------------------------------------- 9 Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved. ===================================================================== Input Routines - Cont. ===================================================================== SETINPT (SCRN%, DISPLEN%, EXIT$, HOTCOL%) Set up routine for a multi-field input screen. ( MULTINPT ) SCRN% is the multi-field input screen designation. (1 - 10). DISPLEN% is the display length for the multi-field input screen. EXIT$ represents the allowable keys which will exit MULTINPT. HOTCOL% is the color of the character specified by the value of HOTPOS% for in field via the call to MAKEFIELD. -------------------------------------------------------------------- 10 Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved. ===================================================================== Directory Routines ===================================================================== DISKSIZE (DRIVE%, SIZE&, FREE&) Finds a disk size and free space in bytes. DRIVE% represents the disk. 1=A, 2=B etc. SIZE& is the total number of bytes of storage capacity. FREE& is the unused bytes. -------------------------------------------------------------------- FINDDIR (PATH$, TYP$. FILE%) Places directory listing of any path in a pre-defined array. PATH$ is the path to search for the directory listing. TYP$ specifies file attributes to include in the directory search. FILE% holds the number of files found in the directory search. -------------------------------------------------------------------- FINDPATH$ ** FUNCTION ** Returns the current path. FINDPATH$ returns the current drive and path in the form: ( DRIVE:\SUB-DIR\.... ) The path always ends with a "\". Examples: B:\ C:\DOS\ D:\GAMES\ A:\ -------------------------------------------------------------------- GETDISK% ** FUNCTION ** Returns the current ( default ) drive. GETDISK% returns the current drive: 1=A, 2=B, etc. -------------------------------------------------------------------- SETDISK (DRIVE%, BADFLAG%) Sets the default drive. DRIVE% is the drive. 1=A, 2=B, etc. BADFLAG% = 1 if an attempt was made to set an invalid drive. -------------------------------------------------------------------- EXEPATH$ ** FUNCTION ** Returns the path of the active executable program. EXEPATH$ returns the executable path as in the following form. ( DRIVE:\SUB-DIR\.... ) The path always ends with a "\". Examples: B:\ C:\DOS\ D:\GAMES\ A:\ -------------------------------------------------------------------- 11 Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved. ===================================================================== Keyboard and Mouse Routines ===================================================================== CLEARKB Clears the keyboard type ahead buffer. -------------------------------------------------------------------- GETAKEY% ** FUNCTION ** Returns the ASCII/IBM or extended value of a key pressed. --------------------------------------------------------------------- LBUTTON% ** FUNCTION ** Returns 1 if the left mouse button is pressed or 0 if not. --------------------------------------------------------------------- MOUSECOL% ** FUNCTION ** Returns the mouse column position of the mouse cursor. --------------------------------------------------------------------- MOUSEHIDE Hides the mouse cursor. --------------------------------------------------------------------- MOUSEINMULT% ( MULTSCRN% ) ** FUNCTION ** Returns the MULTINPT field number the mouse cursor occupies. MULTSCRN% is the MULTINPT screen number. ( 1 to 10 ) --------------------------------------------------------------------- MOUSEINWIND% ( WIND% ) ** FUNCTION ** Returns a value for the mouse cursor position in a window. WIND% is the window number. ( 0 to 20 ). --------------------------------------------------------------------- MOUSELIMIT ( TR%, BR%, LC%, RC% ) Set the bounds for mouse cursor movement. TR% is the top row. BR% is the bottom row. LC% is the left column. RC% is the right column. --------------------------------------------------------------------- 12 Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved. ===================================================================== Keyboard and Mouse Routines - Cont. ===================================================================== MOUSEON% (ISON%) ** FUNCTION ** Attempts to turn the mouse on or off. Returns 1 if the mouse driver and mouse are available or 0 if not available. ISON% = 0 for mouse off, 1 for mouse on. --------------------------------------------------------------------- MOUSEPOS ( ROW%, COL% ) Moves the mouse to a specified display position. ROW% is the row position. COL% is the column position. --------------------------------------------------------------------- MOUSEROW% ** FUNCTION ** Returns the row position of the mouse cursor. --------------------------------------------------------------------- MOUSESHOW Makes the mouse cursor visible. Compliments MOUSEHIDE --------------------------------------------------------------------- RBUTTON% ** FUNCTION ** Returns 1 if the right mouse button is pressed or 0 if not. --------------------------------------------------------------------- 13 Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved. ===================================================================== Info-line Routines ===================================================================== INFOLINE ( ROW%, LC%, WD%, ATTR% ) Turns on the info-line. Saves the display area under same. ROW% is the row position of the info-line. ( 1 to display rows ) LC% is the left column position of the info-line ( 1 to 80 ) WD% is the width of the info-line (1 to 80) ( LC% + WD% must equal less than 82 ) ATTR% is the info-line's color. (1 to 127) --------------------------------------------------------------------- INFOFIXED ( FIXED$ ) Defines a fixed info-string, which prints on calls to PRINTINFO. FIXED$ is the fixed info-string. It will print before any string specified in PRINTINFO. --------------------------------------------------------------------- PRINTINFO ( MESSAGE$ ) Prints a message in the info-line. MESSAGE$ is the message. It is appended to the fixed info-string if one exists. --------------------------------------------------------------------- RSTRINFO ( OFFFLAG% ) Restores the display area under the info-line. Optionally turns off the info-line. OFFFLAG% is set to one to turn off the info-line, 0 to leave on. --------------------------------------------------------------------- 14 Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved. ===================================================================== Other Routines ===================================================================== CUROFF Hides the system cursor. -------------------------------------------------------------------- DISPLAYROWS% ** FUNCTION ** Returns the number of display rows for the active screen mode. -------------------------------------------------------------------- DOSOUND Makes the default sound. -------------------------------------------------------------------- GETCUR& ** FUNCTION ** Returns a long integer representing the system cursor's size and position. -------------------------------------------------------------------- PEEKASM& ( SEGMENT&, OFFSET&, NUMOFBYTES% ) ** FUNCTION ** Returns a long integer holding the value of a specified number of bytes at a specified memory location. SEGMENT& is the segment. ( DOS convention ) OFFSET& is the offset from SEGMENT& NUMOFBYTES% is the number of bytes to read, ( 1 to 4 ) -------------------------------------------------------------------- SETCUR ( CURINFO& ) Restores the cursor position and size. CURINFO& is a long integer returned from function GETCUR& -------------------------------------------------------------------- TWOPOWEROF& (EXPONENT%) ** FUNCTION ** Returns a long integer representing 2 to the "Nth" power. Does not use BASIC's floating point library. EXPONENT% is the exponent for the number 2. -------------------------------------------------------------------- WTIMER& ** FUNCTION ** Returns the systems 1/18th second timer as a long integer. -------------------------------------------------------------------- WVAL& ** FUNCTION ** Returns a long integer representing the value of a numneric string. Does not use BASIC's floating point library. -------------------------------------------------------------------- 15 Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.