CurFld - Revision history

Gordon.dye: /* FKEY Parameter */

2019-05-19T15:22:34Z

FKEY Parameter

← Older revision		Revision as of 15:22, 19 May 2019
Line 66:		Line 66:
	NOTE: If the up arrow was the last key used, the cursor will return to the previous field. If the tab key was used, the cursor will position to the next field with a T (tab stop) attribute.		NOTE: If the up arrow was the last key used, the cursor will return to the previous field. If the tab key was used, the cursor will position to the next field with a T (tab stop) attribute.

	NOTE that the CURFLD function in line 40 is executed only if the value of FKEY is greater than 100. Values of 100 or less are ignored, as are interpreted as an attempt to enter the entire screen.		NOTE that the CURFLD function in line 40 is executed only if the value of FKEY is greater than 100. Values of 100 or less are ignored, as they are interpreted as an attempt to enter the entire screen.

	CURFLD will now process field control attributes such as AEP and #. These control attributes will be ADDED to the control attributes that are specified for a field. Also, the attributes that are specified with CURFLD will OVERRIDE (be used instead of) a floating attribute specified with ATTR. The CURFLD attributes will remain in effect only during the next execution of an INPUT FIELDS or INPUT SELECT statement. Line 20 in the following example uses the X control attribute (see the "X control attribute" discussion in the BRConfig.sys Specifications section for more information).		CURFLD will now process field control attributes such as AEP and #. These control attributes will be ADDED to the control attributes that are specified for a field. Also, the attributes that are specified with CURFLD will OVERRIDE (be used instead of) a floating attribute specified with ATTR. The CURFLD attributes will remain in effect only during the next execution of an INPUT FIELDS or INPUT SELECT statement. Line 20 in the following example uses the X control attribute (see the "X control attribute" discussion in the BRConfig.sys Specifications section for more information).
Line 78:		Line 78:
	If the first field displayed by the above code is left blank, the CURFLD function in line 20 will reposition the cursor to that field and display it in reverse video. The CURFLD function's X attribute will additionally cause an auto-enter to occur when the operator attempts to re-exit the field. If the field passes the test on line 20, and the enter key or a function key was not pressed, the field attribute will resume as an underline and the cursor will be positioned at the next field the operator was trying to move to.		If the first field displayed by the above code is left blank, the CURFLD function in line 20 will reposition the cursor to that field and display it in reverse video. The CURFLD function's X attribute will additionally cause an auto-enter to occur when the operator attempts to re-exit the field. If the field passes the test on line 20, and the enter key or a function key was not pressed, the field attribute will resume as an underline and the cursor will be positioned at the next field the operator was trying to move to.

	[[~~ADS~~]] expects that line 40 will become a standard line of code in all programs that use input fields and validate data.		[[BRC]] expects that line 40 will become a standard line of code in all programs that use input fields and validate data.

	Previously, the CurFld statement supported 3 parameters:		Previously, the CurFld statement supported 3 parameters:

Laura at 18:20, 23 September 2014

2014-09-23T18:20:58Z

← Older revision		Revision as of 18:20, 23 September 2014
Line 9:		Line 9:
	CurFld ([<New_current_field>] [,<New_current_cell>])! if the new current field is a Grid		CurFld ([<New_current_field>] [,<New_current_cell>])! if the new current field is a Grid

	When used without parameters, '''CurFld''' function returns the number of the field containing the [[cursor]] from the last [[INPUT FIELDS]]~~, [[RINPUT FIELDS]], [[INPUT SELECT]], or [[RINPUT SELECT]] operation~~. With parameters, CurFld can be used to set a new starting field (same as the C control [[attribute]]) and/or set a new attribute for the starting field. CurFld may also be used to set the cursor to a cell of a grid or a row in a ListView.		When used without parameters, '''CurFld''' function returns the number of the field containing the [[cursor]] from the last [[INPUT FIELDS]]. With parameters, CurFld can be used to set a new starting field (same as the C control [[attribute]]) and/or set a new attribute for the starting field. CurFld may also be used to set the cursor to a cell of a grid or a row in a ListView.

	In other words, there are three uses for CURFLD:		In other words, there are three uses for CURFLD:
Line 100:		Line 100:

	===Technical Considerations===		===Technical Considerations===

			Note that before BR 4.2, CURFLD could be used with [[RINPUT FIELDS]], [[INPUT SELECT]], or [[RINPUT SELECT]]. But as of 4.2, it is limited to [[INPUT FIELDS]].

	CurFld is initialized to -1 at the start of a new program by the [[RUN]] command.		CurFld is initialized to -1 at the start of a new program by the [[RUN]] command.

Laura at 18:17, 23 September 2014

2014-09-23T18:17:54Z

← Older revision		Revision as of 18:17, 23 September 2014
Line 16:		Line 16:
	#CURFLD(nn) returns the subscript of the current item within the 2D control (LIST or GRID) at relative position nn.		#CURFLD(nn) returns the subscript of the current item within the 2D control (LIST or GRID) at relative position nn.
	#CURFLD(nn,yy) positions the cursor at field yy in 2D control nn when the next INPUT operation is commenced. For LISTs, yy is a row value. For GRIDs it is a cell subscript value.		#CURFLD(nn,yy) positions the cursor at field yy in 2D control nn when the next INPUT operation is commenced. For LISTs, yy is a row value. For GRIDs it is a cell subscript value.

			And, if the control being referenced by nn is not a 2D control, the following parameters are applied during the next INPUT operation-
			#The relative field number.
			#Optional additional field attributes.
			#Optional FKEY value (e.g. right arrow) to be applied for cursor positioning before processing the INPUT.

	===Comments and Examples===		===Comments and Examples===

Laura at 18:16, 23 September 2014

2014-09-23T18:16:45Z

← Older revision		Revision as of 18:16, 23 September 2014
Line 10:		Line 10:

	When used without parameters, '''CurFld''' function returns the number of the field containing the [[cursor]] from the last [[INPUT FIELDS]], [[RINPUT FIELDS]], [[INPUT SELECT]], or [[RINPUT SELECT]] operation. With parameters, CurFld can be used to set a new starting field (same as the C control [[attribute]]) and/or set a new attribute for the starting field. CurFld may also be used to set the cursor to a cell of a grid or a row in a ListView.		When used without parameters, '''CurFld''' function returns the number of the field containing the [[cursor]] from the last [[INPUT FIELDS]], [[RINPUT FIELDS]], [[INPUT SELECT]], or [[RINPUT SELECT]] operation. With parameters, CurFld can be used to set a new starting field (same as the C control [[attribute]]) and/or set a new attribute for the starting field. CurFld may also be used to set the cursor to a cell of a grid or a row in a ListView.

			In other words, there are three uses for CURFLD:

			#CURFLD, without parameters, returns the relative position of the last control (field) occupied during an INPUT operation.
			#CURFLD(nn) returns the subscript of the current item within the 2D control (LIST or GRID) at relative position nn.
			#CURFLD(nn,yy) positions the cursor at field yy in 2D control nn when the next INPUT operation is commenced. For LISTs, yy is a row value. For GRIDs it is a cell subscript value.

	===Comments and Examples===		===Comments and Examples===

Laura at 16:57, 22 May 2014

2014-05-22T16:57:41Z

← Older revision		Revision as of 16:57, 22 May 2014
Line 3:		Line 3:
	CURFLD		CURFLD

	CURFLD ([<New_current_field>] [,<attribute$>] [,FKEY])		CURFLD ([<New_current_field>] [,<attribute$>] [,[[FKEY]]])

	CurFld ([<New_current_field>] [,<New_current_row>]) ! if the new current field is a ListView		CurFld ([<New_current_field>] [,<New_current_row>]) ! if the new current field is a ListView

Laura at 20:08, 20 May 2014

2014-05-20T20:08:35Z

← Older revision		Revision as of 20:08, 20 May 2014
Line 1:		Line 1:
	The '''CurFld''' [[internal function]] has 3 possible combinations of syntax:		The '''CurFld''' [[internal function]] has 4 possible combinations of syntax:

	~~CurFld~~ ([New_current_field] [,attribute$] [,FKEY])		CURFLD

	CurFld ([New_current_field] [,New_current_row]) ! if the new current field is a ListView		CURFLD ([<New_current_field>] [,<attribute$>] [,FKEY])

	CurFld ([New_current_field] [,New_current_cell])! if the new current field is a Grid		CurFld ([<New_current_field>] [,<New_current_row>]) ! if the new current field is a ListView

			CurFld ([<New_current_field>] [,<New_current_cell>])! if the new current field is a Grid

	When used without parameters, '''CurFld''' function returns the number of the field containing the [[cursor]] from the last [[INPUT FIELDS]], [[RINPUT FIELDS]], [[INPUT SELECT]], or [[RINPUT SELECT]] operation. With parameters, CurFld can be used to set a new starting field (same as the C control [[attribute]]) and/or set a new attribute for the starting field. CurFld may also be used to set the cursor to a cell of a grid or a row in a ListView.		When used without parameters, '''CurFld''' function returns the number of the field containing the [[cursor]] from the last [[INPUT FIELDS]], [[RINPUT FIELDS]], [[INPUT SELECT]], or [[RINPUT SELECT]] operation. With parameters, CurFld can be used to set a new starting field (same as the C control [[attribute]]) and/or set a new attribute for the starting field. CurFld may also be used to set the cursor to a cell of a grid or a row in a ListView.

John at 14:45, 7 March 2014

2014-03-07T14:45:00Z

← Older revision		Revision as of 14:45, 7 March 2014
Line 84:		Line 84:
	Note that CURFLD with 2 parameters does not set the initial position of the cursor until the respective control is entered. Also if the mouse is used to enter a control, that will override the specified CURFLD value.		Note that CURFLD with 2 parameters does not set the initial position of the cursor until the respective control is entered. Also if the mouse is used to enter a control, that will override the specified CURFLD value.

	[[~~OPTION~~]] 43 Use old style Input Select with respect to setting CURFLD to the [[NXTFLD]] value when a selection is made. ~~(see [[Section 28]])~~		[[Option]] 43 Use old style Input Select with respect to setting CURFLD to the [[NXTFLD]] value when a selection is made.

	===Technical Considerations===		===Technical Considerations===

John at 16:13, 26 February 2014

2014-02-26T16:13:09Z

← Older revision		Revision as of 16:13, 26 February 2014
Line 1:		Line 1:
	~~Below are the~~ 3 possible combinations of ~~CURFLD~~ syntax:		The '''CurFld''' [[internal function]] has 3 possible combinations of syntax:

	CurFld ([New_current_field] [,attribute$] [,FKEY])		CurFld ([New_current_field] [,attribute$] [,FKEY])

John: moved CURFLD to CurFld over redirect

2014-02-26T16:12:07Z

moved CURFLD to CurFld over redirect

← Older revision	Revision as of 16:12, 26 February 2014
(No difference)

Mikhail.zheleznov: *

2012-02-02T17:26:46Z

← Older revision		Revision as of 17:26, 2 February 2012
Line 1:		Line 1:
	Below are the 3 possible combinations of CURFLD syntax:		Below are the 3 possible combinations of CURFLD syntax:

	CurFld ([New_current_field], [attribute$], [FKEY])		CurFld ([New_current_field] [,attribute$] [,FKEY])

	CurFld ([New_current_field], [New_current_row]) ! if the new current field is a ListView		CurFld ([New_current_field] [,New_current_row]) ! if the new current field is a ListView

	CurFld ([New_current_field], [New_current_cell])! if the new current field is a Grid		CurFld ([New_current_field] [,New_current_cell])! if the new current field is a Grid

	When used without parameters, '''CurFld''' ~~[[statement]]~~ returns the number of the field containing the [[cursor]] from the last [[INPUT FIELDS]], [[RINPUT FIELDS]], [[INPUT SELECT]], or [[RINPUT SELECT]] ~~statement~~. With parameters, CurFld can be used to set a new starting field (same as the C control [[attribute]]) and/or set a new attribute for the starting field. CurFld may also be used to ~~set~~ set the cursor to a cell of a grid or a row in a ListView.		When used without parameters, '''CurFld''' function returns the number of the field containing the [[cursor]] from the last [[INPUT FIELDS]], [[RINPUT FIELDS]], [[INPUT SELECT]], or [[RINPUT SELECT]] operation. With parameters, CurFld can be used to set a new starting field (same as the C control [[attribute]]) and/or set a new attribute for the starting field. CurFld may also be used to set the cursor to a cell of a grid or a row in a ListView.

	===Comments and Examples===		===Comments and Examples===