ProvideX - Beta Release Version April 1998

Transcription

1 Formatted list boxes: ProvideX - Beta Release Version April 1998 List_boxes can now contain format information which is used to describe columnar data and their respective formatting rules. In addition, formatted list boxes can have foreground and background colours as well as multiple lines. To define a formatted list box the FMT= option is used. The data contained in the FMT= string describes each of the columns and/or lines. Each column is defined by a column format specification character followed by a length in column units. Valid format specifiers are: L = Left Justify R = Right Justify C = Center N = Numeric alignment to the last digit or first decimal point B = Insert Spaces The following two specifiers have no length specified. S = Skip column data (used for hidden fields) / = Start a new line All other characters within the format specification are ignored. For Example: LIST_BOX 10,@(10,10,30,10),FMT="L15 R5 N12 C3 / B5 L25" Defines a list box where: Line one has four columns: Col 1 Left justified 15 characters wide Col 2 Right justified 5 characters wide Col 3 Numeric aligned 12 characters wide Col 4 Centered 3 characters wide Line two has two columns Col 1 consists of 5 blanks Col 2 is left justified 25 characters wide The data for each entry in the list box would consist of the contents of columns separated by a SEP, in other words a typical line for the above format would contain: "1123 Main"+sep+"On"+sep+" "+sep+"*"+sep+"Milton"+sep Such that the first column will display "1123 Main", the second will have "On", the third "123.45", and so on. Note, the widths in the specification string represent the width of the display not the number of characters within the field. The length of data within each column is immaterial. If desired, the separator character between each field can be changed by using the SEP= option on the LIST_BOX definition.

2 To change the colour for any field, simply prefix the data with one of the following Mnemonics: Foreground Background Black 'BLACK' '_BLACK' Red 'RED' '_RED' Green 'GREEN' '_GREEN' Yellow 'YELLOW' '_YELLOW' Blue 'BLUE' '_BLUE' Magenta 'MAGENTA' '_MAGENTA' Cyan 'CYAN' '_CYAN' White 'WHITE' '_WHITE' Normally, all background colours are dimmer than their respective foreground colours. If you desire to use the background colour brightness for foreground text, prefix the colour with 'SB'. If you desire to use foreground colour brightness as a background colour, prefix the colour with 'SF' (NOTE: This is not standard text plane colour handling). To get a light gray background, use 'SF'+'_WHITE' since '_WHITE' yields bright white. All colours are reset to list box standards at the end of each column. Sample programs: 0010 OPEN (1) "INVOICE", (2) "CUST" 0020 LIST_BOX 10,@(10,10,60,10),FMT="L8 B2 L30 C10 N15 C3" 0030 READ (1,END=1000) INV_ID$, INV_CUST$,INV_DATE$, INV_AMT$, INV_STS$ 0040 READ (2,KEY=INV_CUST) CST_NAME$ 0050 L$ = INV_ID$! 1St column 0060 L$ += SEP + CST_NAME$! 2nd column 0070 L$ += SEP + INV_DATE$! 3rd column 0080 X$=STR(INV_AMT$:"$###,##0.00-") 0090 IF INV_AMT < 0 X$ = 'RED'+X$! Column is red if negative 0100 L$ += SEP + X$ 0120 X$ = 'SF'+TBL(POS("ISP"=INV_STS$),"",'_GREEN','_BLUE','_RED')+INV_STS$ 0130 L$ += SEP + X$ 0140 LIST_BOX LOAD 10,0,L$ 0150 GOTO CLOSE (1),(2) 1010 INPUT *; IF CTL<>4 GOTO *SAME - or LIST_BOX 10,@(10,10,35,10),FMT="C8 R2 B1 N12 / B5 L30 ",SEP="/" 0020 CLR_CNT= FOR Z=1 TO COLOUR$=ESC+"F"+STR(CLR_CNT),CLR_CNT=(MOD(CLR_CNT+1,7)) 0050 L$="Row:"+STR(Z)+"/"! 1st column 0060 L$+=STR(Z)+"/"! 2nd column 0070 L$+='SB'+COLOUR$+'BR'+STR(RND*100000:"$###,##0.00-")+"/"! 3rd col 0080 L$+='SF'+COLOUR$+"Long Description for Column "+STR(Z)+"/"! 4th col 0090 LIST_BOX LOAD 10,0,L$ 0100 NEXT Z 0110 INPUT *; IF CTL<>4 THEN GOTO *SAME - or to Load multiple lines with a single List_Box Load LIST_BOX 10,@(10,10,35,10),FMT="C8 R2 B1 N12 / B5 L30 ",SEP="/"

3 0020 CLR_CNT=1,LBOX$="" 0030 FOR Z=1 TO COLOUR$=ESC+"F"+STR(CLR_CNT),CLR_CNT=(MOD(CLR_CNT+1,7)) 0050 L$="Row:"+STR(Z)+"/"! 1st column 0060 L$+=STR(Z)+"/"! 2nd column 0070 L$+='SB'+COLOUR$+'BR'+STR(RND*100000:"$###,##0.00-")+"/"! 3rd col 0080 L$+='SF'+COLOUR$+"Long Description for Column "+STR(Z)+"/"! 4th col 0090 LBOX$+=L$+SEP 0100 NEXT Z 0110 LIST_BOX LOAD 10,LBOX$ 0120 INPUT *; IF CTL<>4 THEN GOTO *SAME Note: The value for Field & Row Separators must be different Coloured Syntax for LIST Version 4.02 now supports Coloured Syntax when using the LIST command. There is a new System parameter called 'CS' (Coloured Syntax) that Enables or Disables this feature. There is also a new Mnemonic called '*H' that is used to control the various Colour Codes for the following: The Default syntax colors are: Variables=Blue Literals=Dark Green Remarks=Dark Cyan Errors=Red Mnemonics=Purple Statement Refs=Brown Operators=Dark Red The command mode scan function will use: Highlite=Yellow There is a Command Line Utility routine called "COLOUR" (or "COLOR") that can be used to display or alter the current settings. Typing COLOUR or COLOR at a ProvideX prompt will display online help for this utility. The LST Function has also been enhanced to return statements with coloured Syntax. i.e. X$=LST(* PGM(10)) X$=LST(EDIT * PGM(10)) Year 2000 Date Improvements The DAY_FORMAT directive now allows the format mask to contain the letters AA (e.g. MM/DD/AA) to assist in Y2K conversions. The AA indicates a packed two character year field where we return in the DAY variable A0 for the year 2000, A1 for 2001, B0 for 2010, etc. up to Z9 for the year The JUL function has also been enhanced to accept a valid DAY string and return the corresponding Julian date. For example: X$="01/01/A0" DAY_FORMAT "MM/DD/AA"

4 PRINT JUL(X$) PRINT DTE(10957 : "%Y %Ml %D") 2000 January 1 The DTE function will also support a valid DAY formatted string value. For example: PRINT DTE("01/01/A0" : "%Y %Ml %D") 2000 January 1 PRINT DTE("01/01/A0" : "%Dz/%Mz/%Y") 01/01/2000 The Date & Time functions in ProvideX were also enhanced to compensate for Operating Systems that are not Y2K compliant. European Decimal Changes Version 4.02 has altered the handling of the 'DP' and 'TH' system parameters as follows: 1) The output of a STR() function without a format mask will ignore 'DP' and 'TH' setting 2) The output of a STR() function with a format mask will always use 'DP' and 'TH' setting 3) Numeric data converted during a PRINT directive without a format mask will ignore the 'DP' and 'TH' setting where output with a format mask will use the 'DP' and 'TH' settings. 4) Numeric data converted during a WRITE directive does not use 'DP'/'TH' 5) Numeric data converted during an INPUT/OBTAIN directive without a format mask ignores the 'DP' and 'TH' settings whereas input with a format mask uses the 'DP' and 'TH' settings. 6) Numeric data converted during a READ/FIND/EXTRACT directive does not use the 'DP'/'TH' settings 7) The NUM function will always ignore the 'DP'/'TH' settings In short only formatted input/output uses the 'DP'/'TH' settings. In addition we have added two hidden new system parameters: '!D' - if this parameter is set the system reverts back to the original method of handling 'DP' and 'TH'. '!T' - if this parameter is set then when inputting numeric data either the 'DP' or the true decimal point character (. ) can be entered and will be treated as a decimal point. These parameters are only displayed in the PRM function if set otherwise they are hidden. New *CMD Command Line Routines: Command Line Shortcuts allow a programmer to effectively create new "Directives". These Shortcuts are simple PVX Programs stored in a Directory called "*CMD" (or /pvx/lib/_cmd). The Name of the program/shortcut cannot match any Directive in the language (ie. READ or LIST). It must also start with a letter. When the Name of the Shortcut is entered in console mode, ProvideX compiles the line. If the line would normally generate an Error 20, ProvideX will check the *CMD Directory for a program of the same name as the command which caused the Error 20. Any arguments typed after the Program Name will get passed down into a Single Variable.

5 For example: DELETE 0010 ENTER X$,ERR=*NEXT 0020 IF X$="" THEN X$=STK(0), X$=X$(6) 0030 PRINT "Okay -- I ruined ",X$ 0040 END SAVE "*CMD/RUIN" Now when you type: RUIN "PROGRAM" The response will be: "Okay -- I ruined PROGRAM" Starting with Version 4.02, ProvideX will include the following Shortcuts: CLIP COLOR / COLOUR F JOIN LL VER Take one or more line of code from the current program & Copy them to the Clipboard Routines to change or view the current program LIST colours Find a string in the current program Append two lines together List Labels Report Version info on current program These routines are stored in a Directory called "*CMD/SYSTEM" so they won't conflict with anyone currently using Command Line Shortcuts. When one of these commands is entered, ProvideX will first search the *CMD Directory & then check SYSTEM. Dynamic/Scrolling Window improvements The Mnemonics 'MINSIZE' & 'MAXSIZE' have been added to control the Minimum & Maximum Size of a Scrollable Window. The following example will create a Scrollable Window 80 columns wide by 25 rows high with the initial viewable area set to 30 columns by 10 rows. The Minimum scroll size will be set to 5 columns by 5 rows & the Maximum size will be 40 Columns by 15 rows: PRINT 'DIALOGUE'(1,1,80,25,"Title",'CS',OPT="Z") PRINT 'SIZE'(30,10), PRINT 'MINSIZE'(5,5), PRINT 'MAXSIZE'(40,15), SETTRACE/Trace Windows extensions The ability to display information while tracing a program has been added using the format: SETTRACE PRINT <String Expression> The value generated by the <String Expression> will be displayed in the Debugging Environment Trace Window and/or Printed to the channel being used to capture the SETTRACE output (usually FID(0)). The SETTRACE PRINT <String Expression> is treated like a Remark when no Trace Window or SETTRACE is active. WindX Get_File_Box improvements

6 A new graphical Get_File_Box routine for WindX Clients originally written by Edias International has been added to ProvideX. This routine is not the standard Windows Get_File_Box but rather a ProvideX program called **wdxopn.fle. Windows 32-bit Task/Thread Priority Three new System Parameters have been added to better control the Priority of a Task using the 32-bit version of ProvideX for Windows. The primary purpose of these parameters is too balance the load in a Client/Server environment. The Parameters are as follows: 'Q_' - Lowest Task Priority (default=0) 'Q^' - Highest Task Priority (default=2) 'QF' - Factor (default=1) PVXWIN32.EXE supports five levels of Task/Thread Priority that range from 0 being the lowest through 4 being the highest. By default, all applications run at Level 2 which is set by default using the 'Q^' Parameter. When an application exceeds the Windows Instruction Count (System Parameter 'WI'), its Priority Level is decremented until it reaches the value of the 'Q_' Parameter. The Priority Level is always reset to the 'Q^' value anytime a WAIT is executed or when Terminal Input is requested. The 'QF' Parameter is used to control how frequently the Priority Level is decremented. Setting the 'QF' Parameter to a higher value will force the application to run for a longer duration at the given Priority Level before switching to the next lower Priority Level or until the 'Q_' Parameter is reached. The overall # of instructions between Priority switching is based on an exponential formula using the value of the Windows Instruction Counter (Param 'WI') and the 'QF' Parameter setting. The current Priority Level is stored in TCB(91). Other Enhancements/Corrections: - The EXECUTE directive now supports an ERR= option - The MENU_BAR command has been extended to allow the Menu Bar to be Removed from the screen altogether by issuing a MENU_BAR REMOVE - Added support for Ctrl+Tab & Ctrl+Shift+Tab for switching between Folders in Nomads - The 'TEXT' and 'FONT' Mnemonics now support an attribute of 'N' for Decimal alignment - Formatted IOLISTs now support LEN(0) - Command Line Recall has been enhanced to provide a warning prior to leaving the Edited line when using Up & Down Arrows - Added support for DEFPRT on TCP Files - Added the ability to suppress the Windows Debugging Environment by specifying Debug=-1 in the PVX.INI file - Enhanced WHO & UID System Variables to return Network User Login Name for the 32 bit version of ProvideX for Windows - Allowed a BSZ=n to be used in conjunction with an ISZ=-1 for Binary Files - Corrected an Error 13 while attempting a Multi_line Read 0 - Changed XFA Function to be case insensitive when checking user parameters for BBx compatibility - Extended SORT key size to a maximum of Corrected problems with the 'SL' & 'EL' Mnemonics for WindX connected Printers - Improved support for Purging files on a WindX Client - Resolved issues Purging files immediately after Writing or Removing records - Prevented a GPF when the FID(0) value exceeded 12 characters - Corrected a problem issuing a BEGIN in a program that was PERFORMed from a CALLed program - Enhanced 'IMAGE'(DISABLE X$) to also hide Pictures - Resolved an problem with a SELECT followed immediately by a NEXT RECORD - Adjusted Check Boxes/Radio Buttons to not exceed button size

7 - Enhanced MID("abcde",-2,-4) to yield "abc" not "abcd" - Corrected a Menu Bar re-display issue - Resolved a Print positioning problem on the 1st page of a *winprt* report (Note: This only effected PVXWIN32.EXE) - Forced a 'CR' when Printing to [wdx]*winprt* when the requested column is less than the current column - Increased the # of files to 245 for PVXWIN32.EXE - Corrected a problem printing a Window Title longer than 80 characters - Forced a Buffer Flush for TCP files prior to the Close - Changed the FIN format returned for TCP Files from a Disk style FIN to a Device type FIN - Corrected a problem opening files local to a WindX Client when the Host application has more than 60 files open - Enhanced Check Boxes & Tristate Boxes to Dim the Text when the object is Disabled - Reading a Directory with the 'SD' parameter set no longer returns an Error #12 when a broken Unix Link file is read - Improved handling of lines ending with a ";" for Line Numberless Text Programs - Corrected the FID name returned for *WINPRT* or *WINDEV* - Improved error detection when executing a NEXT RECORD - Improved clean-up of a disconnected WindX station in Client/Server Mode - Corrected Escape sequence handling when using positioning while in Begin Output Transparency Mode ('BO') - Added support for a LEN= option in conjunction with an FMT= on a MULTI_LINE to limit the # of characters allowed after a program issues a Multi_Line Write that violates the Format Mask System Parameters: - Added the 'OL' Parameter to limit the # of Keyed Buffers for OPEN LOADed Files - Added the 'CS' Parameter to Enable/Disable Coloured Syntax - Added the 'IR' Parameter to Reset Insert Mode upon entry of a Decimal during Formatted Numeric Entry - Added Priority Adjust Parameters for the 32 bit version of ProvideX for Windows ('QF'/'Q^'/'Q_'). The current Priority Level is stored in TCB(91). - The '!D' & '!T' Parameters were added to improve handling of European Decimal issues NOMADS Release Notes Block Paste: The Block Paste program now allows you to select the individual controls, menu bar and User controls to be pasted from a selected panel to the current panel. Query: All query screens have been redesigned by using folders. The Fixed/Expression option has been added through out. New options: Name: Auto Tab Place: Header Function: If selected, the query will automatically put focus on the next control upon exit (this is accomplished by the pre-input of a tab on exit) User Defined Controls: A Drop box containing the most common user controls has been added. External Tools:

8 The properties for the selected VBX are now sorted alphabetically in the list box. File Maintenance: You can now generate CUSTOM File Maintenance programs for specific files by selecting the 'Custom' program type option and entering a program name in the 'Parameter Selection' folder of the File Maintenance definition. New Panel Header Attributes: Maximize - This will place the Windows maximize icon in the top right corner of the panel Close Box - This will place the close box or X in the top right corner of the panel Resizeable - When the panel is created you can drag the edges to resize it Resizeable/Auto Scroll- Not only can you resize the panel by dragging the edges, but if the panel is resized smaller horizontal and/or vertical scrollbars are automatically drawn New Attributes on All Controls: Enable Scrolling - Allows the control to scroll within a 'Resizeable/Auto scroll' dialogue box New Multi-line Attributes: Separator - A Drop box of possible separators has been added if you choose to have the contents of a multi-line written to the file with something other than the standard $8A$ New ListBox/DropBox Attributes: Signal on Exit - If this option is selected, the 'ON SELECT' logic will be executed each time Focus leaves the object Other Enhancements/Corrections: Spinner control - Folder Control - System Defaults - Menu Bars - All Controls - Folders - Tabs - Change Directory - Data Classes - Allow numeric entry only and is disabled for a list box or drop box control Query panels have been removed from the list of panels that can be selected Default path, case and grid options are now initially turned on If the help option is enabled on a customized menu bar, Nomads will invoke the help file defined in the Panel header rather than the program help 'ON FOCUS' logic issues have been addressed Timing issues with Title expressions have been corrected Only controls with 'Tab Stop' enabled are displayed in the Tab List Will prompt the user with a Message Box if the directory does not exist and resets focus to the name input field Changed the query file name from PROVIDEX.DCL to providex.dcl for Unix compatibility