View source for 4.18a

[[Business Rules!]] '''Release 4.18''' is stable and is being successfully deployed.  It is the [[solid version]] of [[:Category:Release 4.17|4.17]].

For Initial NEW CONSOLE Features - See "[[New GUI Console]].doc" and [[Printer.Sys]].doc


== 4.18 Changes - 4.18a - [[October 11]], [[2007]] ==

[[OPTION]] 47 Enables the continued use of PRINTER= in [[OPEN]] statements.

OPTION 48 Make ENTER key set [[FKEY]] to 0 even with an FKEY specification.

OPTION 49 Use relative path for spool file name passed in [[SPOOLCMD]].

OPTION 50 Suppress theme usage for text controls. This enables the Windows classical look under XP.

OPTION 51 is an old unpublished and untested option for recovering deleted records during WRITE operations.

OPTION 52 Enables the second click of a double click operation to produce its own interrupt with fkey value 201.

OPTION 53 Allows mouse positioning inside a field other than the current field. Without this option clicking anywhere in a non-current active input field will process it as though the field were entered via the arrow keys.

OPTION 54 exits BR at any console command prompt with a message box showing program name and line number:clause.  Waiting for input by a program has no affect.

Alt+F4 returns Fkey 93.   ( same as clicking the X box )


New field attribute names- for better readability -
Actions- (may precede or follow [attr-names] )
^label - (new) Disallows typing but allows space bar to be treated as ENTER.
^advance - A 
^cursor  - C
^chgexit - E
^nowait  - G
^exit    - X
^leave   - L
^protect - P   (applies [inactive] color attribute )

Display Characteristics- (must follow [attr-names] )
^combo   - Q
^sunken  - S
^tab     - T

SCREEN Statement References- (must follow [attr-names] )
N,B,H,R,U,I

Note-  Field attribute specifications normally should appear in the following order:

*	[attrib-name]
*	override attributes (A, E, X etc.)
*	color
*	font  (in ATTRIBUTE statements only)

Note- Config [attributes] do NOT store actions.  They only store screen display characteristics.



HELP (tool tips) on PRINT FIELDS is now supported. Example:
PRINT FIELDS #nn,"10,10,P 8/15,450", HELP str$: "myimage.jpg:ISOTROPIC"

Support for MIN_FONTSIZE in pixels - e.g. MIN_FONTSIZE=20x10
If a window is shrunk below this limit, scrollbars are displayed.


[[EDIT]] with no program will edit the program named MYSPACE.

EDIT ~ [ program-name ] will perform EDIT 'enter' processing. That is it will compare the edited source file with the program in memory and store the differences.

*EDIT - uses the previous editor source file

*Shell call parameter lists have been expanded to the maximum BR line length (currently 800).

*Support for the DEBUG CONSOLE OFF command.

*If the first [[drive]] statement fails BR defaults it to "Drive C:,.,x,\".  This lets the program scout around to dynamically create a drive statement.

*[[RENUM]] LABELS_ONLY parameter introduced

===new CONFIG statement(s)===
*COLOR [C1]#112233 where C1 can be up to 12 characters.
[C1] can then be substituted for # color values wherever they appear.

[[STATUS]] COLORS shows what COLOR statements are in effect


===New Internal Functions===
*[[OS_FILENAME$]]("br-filename")
*[[BR_FILENAME$]]("os-filename")

===NWP Improvements===
[[NWP]] support has been added for \Eleft_justify, \Eright_justify and \Ecenter. Any of the following delineate blocks:
CHR$(5), pipe ( | ), \Ebegin.., \Eend.., \Eleft.., etc.

Draft mode is now supported under [[NWP]] - use Epson codes to set it.
( See NWP.DOC for [[Native Windows Printing]] specifications )

The following syntax can be used to shift the entire contents of a page up/down and or left/right.  This can be useful for page binding or other offset purposes. Left and top offset registration now move everything on the page a given distance in decipoints (720 decipoints = 1 inch). Negative numbers shift up and left. 

	&l#U  Left offset registration
	&l#Z  Top offset registration


PREVIEW provides case insensitive Search capability.
PREVIEW saves the user preference for % of amplification across sessions.

=== Tabbed Window Enhancements ===
*[[Ctrl+Tab]]		Switches to next tab window
*[[Ctrl+Shift+Tab]]	Switches to prior tab window

CURTAB with no parms returns the window number of the last tab clicked.


Mouse Button scan codes can now be remapped with [[BRconfig.sys]] keyboard statements.

Config INSERT will be overridden by user preferences. If [[MIN_LENGTH]] is specified there will be both a long and a short user preference concerning INSERT. The user expresses his preference by entering a long or short field and setting the insert mode. Insert preferences will remain in effect until changed by the user for the duration of the session.

DIR -o sorts on long file names. 

BR allows for dynamic activation of field specs for programmed screen generation by ignoring zero length fields. If a non-null value is provided with a zero display length it is treated as if no length were specified ( the length is assumed to be the length of the data )"row,col,C 0" with null data will be ignored.

--------------------------------------------------------------------
[[File Browser]] introduced.

--------------------------------------------------------------------

Keyboard use with GRIDs has been refined-
In GRID navigation mode - without shift Right Arrow wraps to the first cell of the next row. If in the last cell, it wraps to the first cell unless the row has the L attribute or some other attribute that causes an exit of the [[2D Control]]. Left Arrow works alike in reverse.

If a GRID input is attempted on a protected field, BR issues a Bell. 

The space bar can be used to select (multiple rows) when ctrl is depressed. It doesn't lose selections when switching between mouse and keyboard with ctrl depressed.

--------------------------------------------------------------------
Debug Statement Table - used by LOAD to apply debug statements

The -p parameter specifies which program or programs the statement pertains to. If not specified, then the full BR path to the current program is stored as the program name search string. However the substring value could be used as a mask to apply to multiple program libraries.

e.g   BREAK -p lib BEGIN.

This would break upon entry to any program file that has LIB as part of the name. Note that the program name substring is case insensitive.

DISPLAY [ -p program-name-substr ]  ALL  [ OFF | PRINT | >filename ]
DISPLAY [ -p prog-name-substr ] var-name [ OFF | PRINT | >filename]

BREAK [ -p program-name-substring ]  BEGIN [ OFF ]  (break upon entry)
BREAK [ -p program-name-substring ]  variable-name  [ OFF ]
BREAK [ -p program-name-substring ]  line[:clause]  [ OFF ]
BREAK [ -p program-name-substring ]  label:[clause]  [ OFF ]
BREAK [ -p program-name-substring ]  FNname  [ OFF ]

BREAK ALL OFF

STATUS BREAK displays all debug settings

--------------------------------------------------------------------

=== New ERROR CODES relating to debugging ===
*[[0420]]	Operation not permitted with [[debugger]] attached 
*[[0422]]	Unknown host name
*[[0424]]	Connection failed
*[[0426]]	Bad port defined
*[[0428]]	Accept failed
*[[0430]]	Not processing input command mode
*[[0432]]	The given clause number is invalid

=== Errors Corrected ===

[[Shift+PgUp]] and [[Shift+PgDn]] selects within a [[List/Grid]].

If the current day is not given in a date specification such as MONTH CY then we now use the first day of the month. 

When redirecting output of a STATUS command that references a filename, the redirection may be specified after the filename qualifier.
e.g.   STATUS FILES ORDERH >filename

> is now < when denoting that the end of a field has been reached.

Tabs were failing with [[FORCE_VISIBILITY]] on.

In [[NWP]] tabs were not positioning correctly to the NEXT tab position.

PRINT BORDER :   with no specs is no longer allowed

A number of problems concerning Windows on tabs were corrected.

Finish fixing keyboard navigation problems with [[GUI]] controls.
mainly combo boxes, check boxes on tabbed windows

DIR *.XXX no longer accesses *.XXXX

Allow [[CurFld]] to exceed [[65535]].

We now left justify all fields during input mode for [[GUI]] off.

Dynamically resizes Fonts On Tab Captions. 

[[COPY]] and [[RENAME]] with not TO filename specified causes unpredictable results.

[[NWP]] positioning errors were corrected:
Setting Top margin with &l#E no longer moves the current printing position. Setting absolute position by row with &a#R now correctly uses the first line offset.

Shift F4 - step over line - got hung up on shell calls

The command line is now cleared in the linux model when an interrupt occurs.

ENV$("Clipboard") always returned an added NULL (chr$(0)) character. 
This has been corrected.



Document-

OPEN #1:"name=.PRN:/Select.....
  IF FILE$(1)="CANCELED" THEN ... operator canceled

Use INPUT FIELDS ... NOWAIT to raise a TAB.

File numbers may be in the range 300-999 in addition to the customary 1-199. 

Client Server [[brlistener.conf]] STDERR= parameter applies when no LOGGING statement has been processed. OS error and BR exit error messages are directed here.

[[Category:Release 4.18]]
[[Category:Release Notes]]