Open Window - Revision history

Gordon.dye: /* Defaults */

2017-05-06T15:04:07Z

Defaults

← Older revision		Revision as of 15:04, 6 May 2017
Line 73:		Line 73:
	:1.) No border.		:1.) No border.
	:2.) N (normal).		:2.) N (normal).
	:3.) ABSOLUTE.		:3.) ABSOLUTE for window zero, RELATIVE for child windows.
	:4.) No caption.		:4.) No caption.
	:5.) Center caption.		:5.) Center caption.

Gordon.dye: /* Defaults */

2017-05-06T15:02:58Z

Defaults

← Older revision		Revision as of 15:02, 6 May 2017
Line 73:		Line 73:
	:1.) No border.		:1.) No border.
	:2.) N (normal).		:2.) N (normal).
	:3.) No caption.		:3.) ABSOLUTE.
	:4.) Center caption.		:4.) No caption.
	:5.) Interrupt the program if an error occurs and ON is not active.		:5.) Center caption.
	~~:6.) N (normal)~~.		:6.) Interrupt the program if an error occurs and ON is not active.

	===Parameters===		===Parameters===

Gordon.dye: /* Syntax */

2017-05-06T14:58:08Z

Syntax

← Older revision		Revision as of 14:58, 6 May 2017
Line 65:		Line 65:

	===Syntax===		===Syntax===
	OPEN #<window number>: {"{[[ROWS]]\|[[SROW]]} =<integer> {[[COLS]]\|[[SCOL]]} =<integer> {[[ROWS]]\|[[EROW]]} =<integer> {[[COLS]]\|[[ECOL]]}=<integer> [, [[Border Spec\|BORDER]]=<spec>] [, N=<[[attributes]]>] [[[ABSOLUTE]]\|[[RELATIVE]]] [, [[CAPTION]]=[{<\|>}] <title>]"\|<[[string expression]]>} , [[DISPLAY]], {[[Input Parameter\|INPUT]]\|[[OUTPUT]]\|[[OUTIN]]} [<[[error condition]]> <[[line ref]]>][,...]		OPEN #<window number>: {"{[[ROWS]]\|[[SROW]]} =<integer> {[[COLS]]\|[[SCOL]]} =<integer> {[[ROWS]]\|[[EROW]]} =<integer> {[[COLS]]\|[[ECOL]]}=<integer> [, [[Border Spec\|BORDER]]=<spec>] [, N=<[[attributes]]>] [ [[FKEY=]]<value>] [, [[ABSOLUTE]]\|, [[RELATIVE]]] [, [[CAPTION]]=[{<\|>}] <title>]"\|<[[string expression]]>} , [[DISPLAY]], {[[Input Parameter\|INPUT]]\|[[OUTPUT]]\|[[OUTIN]]} [<[[error condition]]> <[[line ref]]>][,...]

	ROWS and COLS can be specified with either SROW and SCOL or EROW and ECOL, but not both.		ROWS and COLS can be specified with either SROW and SCOL or EROW and ECOL, but not both.

Gordon.dye at 23:22, 9 November 2014

2014-11-09T23:22:31Z

← Older revision		Revision as of 23:22, 9 November 2014
Line 26:		Line 26:
	00200 open #2: "srow=2,scol=2,EROW=10,ECOL=30,border=b, caption=Happy Border",display,outin		00200 open #2: "srow=2,scol=2,EROW=10,ECOL=30,border=b, caption=Happy Border",display,outin

	The valid border styles are B (~~bold~~) and S (~~drop-shadow~~). See "S Attribute" in the [[BRConfig.sys]] Specification section for more information. Try each of them to see their effects.		The valid border styles are B (blank), S (single line) and D (double line). See "S Attribute" in the [[BRConfig.sys]] Specification section for more information. Try each of them to see their effects.

	:3) Window zero is the main BR operator console. You can also reopen it whenever desired. For example you may want to change the number or rows and columns. Since you cannot explicitly close it, reopening it implies closure of the pre-existing window 0. See [[Screen OpenDflt]] for the normal way to specify main window attributes.		:3) Window zero is the main BR operator console. You can also reopen it whenever desired. For example you may want to change the number or rows and columns. Since you cannot explicitly close it, reopening it implies closure of the pre-existing window 0. See [[Screen OpenDflt]] for the normal way to specify main window attributes.

Gordon.dye: /* Syntax */

2014-11-07T14:01:15Z

Syntax

← Older revision		Revision as of 14:01, 7 November 2014
Line 66:		Line 66:
	===Syntax===		===Syntax===
	OPEN #<window number>: {"{[[ROWS]]\|[[SROW]]} =<integer> {[[COLS]]\|[[SCOL]]} =<integer> {[[ROWS]]\|[[EROW]]} =<integer> {[[COLS]]\|[[ECOL]]}=<integer> [, [[Border Spec\|BORDER]]=<spec>] [, N=<[[attributes]]>] [[[ABSOLUTE]]\|[[RELATIVE]]] [, [[CAPTION]]=[{<\|>}] <title>]"\|<[[string expression]]>} , [[DISPLAY]], {[[Input Parameter\|INPUT]]\|[[OUTPUT]]\|[[OUTIN]]} [<[[error condition]]> <[[line ref]]>][,...]		OPEN #<window number>: {"{[[ROWS]]\|[[SROW]]} =<integer> {[[COLS]]\|[[SCOL]]} =<integer> {[[ROWS]]\|[[EROW]]} =<integer> {[[COLS]]\|[[ECOL]]}=<integer> [, [[Border Spec\|BORDER]]=<spec>] [, N=<[[attributes]]>] [[[ABSOLUTE]]\|[[RELATIVE]]] [, [[CAPTION]]=[{<\|>}] <title>]"\|<[[string expression]]>} , [[DISPLAY]], {[[Input Parameter\|INPUT]]\|[[OUTPUT]]\|[[OUTIN]]} [<[[error condition]]> <[[line ref]]>][,...]

			ROWS and COLS can be specified with either SROW and SCOL or EROW and ECOL, but not both.
	[[Image:Openwindow.png\|900px]]		[[Image:Openwindow.png\|900px]]

Gordon.dye at 13:37, 7 November 2014

2014-11-07T13:37:40Z

← Older revision		Revision as of 13:37, 7 November 2014
Line 1:		Line 1:
	See also: [[Parent=None]] and [[Picture]]		See also: [[Parent=None]] and [[Picture]]

	The '''OPEN window''' (OPE) [[statement]] specifies the characteristics for a window and activates the window for input/output. OPEN window can specify the following window characteristics: ~~screen~~ placement and dimensions~~, border~~ type and attributes~~, attributes~~ to be used for the text area of the window~~, and a~~ caption to be displayed within the top border of the window.		The '''OPEN window''' (OPE) [[statement]] specifies the characteristics for a window and activates the window for input/output. OPEN window can specify the following window characteristics:
			* Screen placement and dimensions
			* Border type and attributes
			* Attributes to be used for the text area of the window
			* A caption to be displayed within the top border of the window

	~~:1.) When a file is opened for both SHR and INPUT, Business Rules will no longer change~~ the ~~time and date of~~ the ~~file. As a result of this change~~, ~~when a file is to be opened~~ both ~~for OUTIN and for INPUT~~, the ~~OPEN for OUTIN must~~ be ~~executed first. Otherwise an error [[0608]] will result. This will affect current programs.~~		The ROWS= parameter may be used in place of either the SROW= or the EROW= parameter, but not both. Likewise, the COLS= parameter may be used in place of either the SCOL= or the ECOL= parameter, but not both.
	~~:2.) The OPEN window statement now allows for flexibility~~ in ~~the specification of window coordinates. Previously all four coordinates~~ of the window had to be specified in terms of two exact row positions and two exact column positions. With release 3.50, only one exact row position and one exact column position must be specified. Business Rules will automatically calculate the other row and/or ~~column position according to the values of~~ the ~~ROWS~~= ~~and COLS= parameters~~, ~~which indicate the desired length or width of the window~~.

	The ROWS= parameter may be used in place of either the SROW= or the EROW= parameter, but not both. Likewise, the COLS= parameter may be used in place of either the SCOL= or the ECOL= parameter, but not both. The following examples show some of the possibilities that are available using this syntax option. Each statement opens a 10 row by 10 column window in the upper left corner of the screen. (NOTE: ROWS= and COLS= parameters are shown in lowercase for emphasis; case makes no difference in actual syntax.)		The following examples show some of the possibilities that are available using this syntax option. Each statement opens a 10 row by 10 column window in the upper left corner of the screen. (NOTE: ROWS= and COLS= parameters are shown in lowercase for emphasis; case makes no difference in actual syntax.)

	00010 OPEN #1:"rows=10,cols=10,EROW=10,ECOL=10",DISPLAY,OUTPUT		00010 OPEN #1:"rows=10,cols=10,EROW=10,ECOL=10",DISPLAY,OUTPUT
Line 17:		Line 20:
	00080 OPEN #1:"SROW=1,SCOL=1,EROW=10,cols=10",DISPLAY,OUTPUT		00080 OPEN #1:"SROW=1,SCOL=1,EROW=10,cols=10",DISPLAY,OUTPUT

	:3.) ~~The OPEN~~ window ~~statement's BORDER parameter now accepts S (drop-shadow~~) ~~as an attribute for the border. See "S Attribute" in the [[BRConfig.sys]] Specification section for more information.~~		:1) All open windows other than the main BR console (window 0) are closed whenever a program ends.
	~~:4.) The NOCLOSE parameter in any OPEN statement will leave that file open when~~ a program ends ~~or chains to another program. The only way this file is closed is by explicitly closing the file, CLEAR ALL, or by exiting from Business Rules~~.

	~~00010~~ OPEN #1:~~"NAME=TEST,NOCLOSE",INTERNAL,RELATIVE,INPUT~~		:2) You can also specify window borders and captions in the OPEN WINDOW statement, for example:

	:~~5.) Window borders and captions can also be specified in the OPEN WINDOW statement~~, ~~for example:~~		00200 open #2: "srow=2,scol=2,EROW=10,ECOL=30,border=b, caption=Happy Border",display,outin

	~~00200 open #2:~~ "~~srow=2,scol=2,EROW=10,ECOL=30,border=b, caption=Happy Border~~"~~,display,outin~~		The valid border styles are B (bold) and S (drop-shadow). See "S Attribute" in the [[BRConfig.sys]] Specification section for more information. Try each of them to see their effects.

	~~The valid border styles are B~~ and ~~S (S looks better)~~		:3) Window zero is the main BR operator console. You can also reopen it whenever desired. For example you may want to change the number or rows and columns. Since you cannot explicitly close it, reopening it implies closure of the pre-existing window 0. See [[Screen OpenDflt]] for the normal way to specify main window attributes.

	===Comments and Examples===		===Comments and Examples===
	~~Business Rules creates two different types of windows: windows that are opened as separate input/output files, and field help windows. The~~ OPEN ~~window statement allows you to create~~ the ~~first type, windows that accept input and output~~. ~~For information about field help~~ windows~~, see [[Screen I/O]]~~.		OPEN #0 is reserved for reopening the BR main console. Windows 1-999 typically are sub-windows on window 0. Windows can also be opened separately from the main window. See [[Parent=None]] for more information.

	Windows can also be opened separately from the main window. ~~OPEN #0 is reserved for this. Also see~~ [[Parent=~~Window~~]] for more information.

	~~Regarding window size : (as of 4.3) when~~ opening separate windows, 'NAME=window-name' indicates that BR is to save the position of the window at the time it is closed and restore it to that position when it is reopened, even across sessions. Replacement or overlaying windows can use the same window names to position themselves ~~wherever and~~ at whatever character size the user has changed it to. So once a window has been opened with a particular name, subsequent opens ignore ROW= and COL= and instead use the user positioned values.		When opening separate windows, 'NAME=window-name' indicates that BR is to save the position of the window at the time it is closed and restore it to that position when it is reopened, even across sessions. Replacement or overlaying windows can use the same window names to position and size themselves at whatever position and character size the user has changed it to. So once a window has been opened with a particular name, subsequent opens ignore ROW= and COL= and instead use the user positioned values.

	As a result window positioning and size priority is as follows:		As a result window positioning and size priority is as follows:

Laura: /* Technical Considerations */

2014-09-25T16:59:14Z

Technical Considerations

← Older revision		Revision as of 16:59, 25 September 2014
Line 119:		Line 119:
	:5.) SROW and SCOL are based on FONTSIZE.		:5.) SROW and SCOL are based on FONTSIZE.

			====Sample Program====
			00100 ! Run This Program With The Br Main Screen Unmaximized
			00120 ! Run It More Than Once With The Br Main Screen In Different Positions
			00140 ! Repositioning The Named Windows Are Be Remembered From Run To Run.
			00160 open #1: "parent=none,RELATIVE,srow=0,scol=0, rows=10,cols=50,fontsize=20x10",display,output
			00180 print #1, fields "1,1,c,s": "This PARENT=NONE window was positioned relative to window #0. Press any key to continue"
			00200 let KSTAT$(1)
			00220 close #1:
			00240 open #1: "parent=none,RELATIVE,srow=-4,scol=-4, rows=10,cols=50,fontsize=20x10",display,output
			00260 print #1, fields "1,1,c,s": "This PARENT=NONE window was also positioned relative to window #0. It uses a negative SROW and SCOL. Press any key to continue"
			00280 let KSTAT$(1)
			00300 close #1:
			00320 open #1: "parent=none,ABSOLUTE,srow=0,scol=0, rows=10,cols=50,fontsize=20x10",display,output
			00340 print #1, fields "1,1,c,s": "This PARENT=NONE window was positioned on the absolute screen coordinates. Press any key to continue"
			00360 let KSTAT$(1)
			00380 close #1:
			00400 open #1: "parent=none,ABSOLUTE,srow=10,scol=10, rows=10,cols=50,fontsize=20x10",display,output
			00420 print #1, fields "1,1,c,s": "This PARENT=NONE window was positioned on the absolute screen coordinates at 10,10. Note that SROW and SCOL are now measured in character sizes based on the specified FONTSIZE. Press any key to continue"
			00440 let KSTAT$(1)
			00460 close #1:
			00480 open #1: "parent=none,ABSOLUTE,srow=0,scol=0, rows=10,cols=50,fontsize=20x10,name=AbsolutePositionExample_1",display,output
			00500 print #1, fields "1,1,c,s": "This PARENT=NONE window was positioned on the absolute screen coordinates. This window saves its screen size and position based on name=AbsolutePositionExample_1. You can move this window around and it will open in the new place the next time you run this example. Press any key to continue"
			00520 let KSTAT$(1)
			00540 close #1:
			00560 open #1: "parent=none,RELATIVE,srow=0,scol=0, rows=10,cols=50,fontsize=20x10,name=RelativePositionExample_1",display,output
			00580 print #1, fields "1,1,c,s": "This PARENT=NONE window was positioned relative to window #0. This window saves its screen size and position based on name=RelativePositionExample_1. It saves this information relative to window #0. You can move this window around and it will open in the new place relative to window #0 the next time you run this example. Note: This saved position is relative to window #0. This means that if window #0 is moved, the saved position will move right along with it. Press any key to continue"
			00600 let KSTAT$(1)
			00620 close #1:
			00640 print fields "1,1,c,,B1001": "This button cannot be clicked while there is a modal window open"
			00660 open #1: "parent=none, RELATIVE, srow=10, scol=10, rows=10, cols=50, fontsize=20x10, MODAL", display, output
			00680 print #1, fields "1,1,c,s": "This window was opened MODAL. Note that you cannot interact with window #0 while it is opened. Also note that it does not have a task bar icon. Press Ok to continue"
			00700 print #1, fields "6, 22, C,,B1001": "Ok"
			00720 do WHILE (FKEY <> 1001)
			00740 let KSTAT$(1)
			00760 loop
			00780 close #1:
			00800 print NEWPAGE
			00820 open #1: "parent=none,RELATIVE,srow=0,scol=0, rows=10,cols=50,fontsize=20x10, NO_TASK_BAR", display, output
			00840 print #1, fields "1,1,c,s": "This PARENT=NONE window does not have a task bar item. Press any key to continue"
			00860 let KSTAT$(1)
			00880 close #1:

	<noinclude>		<noinclude>

Laura: /* Comments and Examples */

2014-09-23T16:25:40Z

Comments and Examples

← Older revision		Revision as of 16:25, 23 September 2014
Line 38:		Line 38:
	:1. NAME= window-name		:1. NAME= window-name
	:2. (for window zero only) un-named save font size and position.		:2. (for window zero only) un-named save font size and position.
	:3. SROW, SCOL, MAXIMIZE, NOMAXIMIZE, ABSOLUTE, RELATIVE, FONTSIZE		:3. SROW, SCOL, MAXIMIZE, [[NOMAXIMIZE]], ABSOLUTE, RELATIVE, FONTSIZE

	Another attribute (that doesn't get saved) is OVERRIDE, which indicates that the SROW and SCOL (etc) settings in the OPEN statement are to be used even if NAME= is also specified. When OVERRIDE is specified in OPENDFLT, it only applies to the first OPEN of window #0. In all other cases Name= trumps SROW etc settings.		Another attribute (that doesn't get saved) is OVERRIDE, which indicates that the SROW and SCOL (etc) settings in the OPEN statement are to be used even if NAME= is also specified. When OVERRIDE is specified in OPENDFLT, it only applies to the first OPEN of window #0. In all other cases Name= trumps SROW etc settings.
Line 45:		Line 45:
	opened RELATIVE.		opened RELATIVE.

	"NOMAXIMIZE" also removes the maximize button from ~~the~~ window.		"NOMAXIMIZE" also removes the maximize button from window #0 and parent=none windows.

	"NO_TASK_BAR" suppresses the task bar icon. This feature		"NO_TASK_BAR" suppresses the task bar icon. This feature

Laura: /* Hot Windows */

2014-09-22T20:31:03Z

Hot Windows

← Older revision		Revision as of 20:31, 22 September 2014
Line 62:		Line 62:
	===Hot Windows===		===Hot Windows===

	As of 4.2, FKEY= may be specified in a window OPEN statement. This makes the window hot, so a user can click anywhere in the window to tell the program that they want to switch focus. This characteristic is inheritable, but not to independent windows. In other words, assigning an FKEY value to a window automatically assigns the same FKEY value to it's child windows, unless another FKEY ( or -1 ) is assigned to a child.		As of 4.2, FKEY= may be specified in a window OPEN statement. This makes the window hot, so a user can click anywhere in the window to tell the program that they want to switch focus. This characteristic is inheritable, but not to independent windows. In other words, assigning an FKEY value to a window automatically assigns the same FKEY value to it's child windows, unless another FKEY (or -1) is assigned to a child.

	===Syntax===		===Syntax===

Laura: /* Input Across Multiple Windows */

2014-09-22T20:30:45Z

Input Across Multiple Windows

← Older revision		Revision as of 20:30, 22 September 2014
Line 59:		Line 59:

	This will input the first two fields on window #121 and the third field on window #124. The ‘#window-number,’ prefix may appear in any row or col FIELDS specification and overrides the window number that follows the PRINT/INPUT/RINPUT keyword.		This will input the first two fields on window #121 and the third field on window #124. The ‘#window-number,’ prefix may appear in any row or col FIELDS specification and overrides the window number that follows the PRINT/INPUT/RINPUT keyword.

			===Hot Windows===

			As of 4.2, FKEY= may be specified in a window OPEN statement. This makes the window hot, so a user can click anywhere in the window to tell the program that they want to switch focus. This characteristic is inheritable, but not to independent windows. In other words, assigning an FKEY value to a window automatically assigns the same FKEY value to it's child windows, unless another FKEY ( or -1 ) is assigned to a child.

	===Syntax===		===Syntax===