Nxtfld - Revision history

Laura at 18:21, 23 September 2014

2014-09-23T18:21:31Z

← Older revision		Revision as of 18:21, 23 September 2014
Line 1:		Line 1:
	The '''NxtFld''' [[internal function]] ~~works the same way as~~ [[Curfld]] except that it ~~takes into account~~ the ~~way~~ the ~~field was exited and reports~~ the ~~number of~~ the ~~field that the cursor is going~~ to ~~enter next~~.		The '''NxtFld''' [[internal function]] is similar to [[Curfld]] except that it returns the relative position of the next control to be occupied during an INPUT operation (the one the user clicked on or attempted to move to).

	Two methods are used to identify clicked controls: Fkey numbers and NXTFLD. This will keep track of which control was clicked when a user clicks on a hot control (a control that has an Fkey assigned). If the control is a GRID or LIST then it keeps track of where the user clicked within the control.		Two methods are used to identify clicked controls: Fkey numbers and NXTFLD. This will keep track of which control was clicked when a user clicks on a hot control (a control that has an Fkey assigned). If the control is a GRID or LIST then it keeps track of where the user clicked within the control.

Laura at 18:01, 23 September 2014

2014-09-23T18:01:50Z

← Older revision		Revision as of 18:01, 23 September 2014
Line 1:		Line 1:
	The '''NxtFld''' [[internal function]] works the same way as [[Curfld]] except that it takes into account the way the field was exited and reports the number of the field that the cursor is going to enter next.		The '''NxtFld''' [[internal function]] works the same way as [[Curfld]] except that it takes into account the way the field was exited and reports the number of the field that the cursor is going to enter next.

			Two methods are used to identify clicked controls: Fkey numbers and NXTFLD. This will keep track of which control was clicked when a user clicks on a hot control (a control that has an Fkey assigned). If the control is a GRID or LIST then it keeps track of where the user clicked within the control.

	If a control that is part of an active Input Fields operation is double clicked, then NXTFLD will identify the relative position of the control within the Fields operation. However, for hot field identification it is necessary to use Fkey values to identify the respective controls.		If a control that is part of an active Input Fields operation is double clicked, then NXTFLD will identify the relative position of the control within the Fields operation. However, for hot field identification it is necessary to use Fkey values to identify the respective controls.

Laura: /* FKEY Parameter */

2014-09-23T17:59:50Z

FKEY Parameter

← Older revision		Revision as of 17:59, 23 September 2014
Line 65:		Line 65:
	00050 !.. output		00050 !.. output

	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 NXTFLD function in line 20 will reposition the cursor to that field and display it in reverse video. The NXTFLD 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.		[[ADS]] 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 NxtFld statement supported 3 parameters:

	# The relative field number.		# The relative field number.
Line 77:		Line 77:
	In the event the first parameter points to a [[2D field/control]] then instead of the FKEY value, the third (or second numeric) parameter is interpreted as the subscript of the item within the 2D control. For LISTs, this is a row value. For GRIDs this is a Cell Subscript Value. For TOOLBARs, it is the icon subscript value (relative position in toolbar).		In the event the first parameter points to a [[2D field/control]] then instead of the FKEY value, the third (or second numeric) parameter is interpreted as the subscript of the item within the 2D control. For LISTs, this is a row value. For GRIDs this is a Cell Subscript Value. For TOOLBARs, it is the icon subscript value (relative position in toolbar).

	Also, in the event the first parameter points to a 2D field/control then the ~~CURFLD~~ function returns the subscript of the current item within the 2D control.		Also, in the event the first parameter points to a 2D field/control then the NXTFLD function returns the subscript of the current item within the 2D control.

	The ~~CURFLD~~ system function has been extended to support the current selection upon entry to a multi-field control. The first parameter specifies which field/control is to be affected and the second parameter is the subscript of the cursor upon entry to that control. In the event the first parameter points to a 2D field/control then instead of the FKEY value, the third (or second numeric) parameter is interpreted as the subscript of the item within the 2D control.		The NXTFLD system function has been extended to support the current selection upon entry to a multi-field control. The first parameter specifies which field/control is to be affected and the second parameter is the subscript of the cursor upon entry to that control. In the event the first parameter points to a 2D field/control then instead of the FKEY value, the third (or second numeric) parameter is interpreted as the subscript of the item within the 2D control.
	:\|For LISTviews this is a row value.		*For LISTviews this is a row value.
	:\|For GRIDs this is a Cell Subscript Value.		*For GRIDs this is a Cell Subscript Value.
	:\|For TOOLBARs it is the icon subscript value (relative position in toolbar).		*For TOOLBARs it is the icon subscript value (relative position in toolbar).

	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 NXTFLD 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 NXTFLD value.

	[[Option]] 43 Use old style Input Select with respect to setting CURFLD to the [[NXTFLD]] value when a selection is made.		[[Option]] 43 Use old style Input Select with respect to setting CURFLD to the [[NXTFLD]] value when a selection is made.

			<noinclude>
			[[Category:Internal Functions]]
			</noinclude>

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

Laura at 17:56, 23 September 2014

2014-09-23T17:56:31Z

@@ Line 1: / Line 1: @@
 The '''NxtFld''' [[internal function]] works the same way as [[Curfld]] except that it takes into account the way the field was exited and reports the number of the field that the cursor is going to enter next.
-====Related Functions====
+If a control that is part of an active Input Fields operation is double clicked, then NXTFLD will identify the relative position of the control within the Fields operation. However, for hot field identification it is necessary to use Fkey values to identify the respective controls.
 *[[CurFld]]
 *[[CurRow]]

Laura at 19:10, 23 July 2013

2013-07-23T19:10:37Z

← Older revision		Revision as of 19:10, 23 July 2013
Line 12:		Line 12:
	<noinclude>		<noinclude>
	[[Category:Internal Functions]]		[[Category:Internal Functions]]
	~~[[Category:Window File Processing Statements]]~~
	</noinclude>		</noinclude>

Laura at 19:10, 23 July 2013

2013-07-23T19:10:18Z

← Older revision		Revision as of 19:10, 23 July 2013
Line 1:		Line 1:
	The '''NxtFld''' [[~~statement~~]] works the same way as [[Curfld]] except that it takes into account the way the field was exited and reports the number of the field that the cursor is going to enter next.		The '''NxtFld''' [[internal function]] works the same way as [[Curfld]] except that it takes into account the way the field was exited and reports the number of the field that the cursor is going to enter next.

	====Related Functions====		====Related Functions====
Line 11:		Line 11:

	<noinclude>		<noinclude>
	[[Category:~~Statements~~]]		[[Category:Internal Functions]]
	[[Category:Window File Processing Statements]]		[[Category:Window File Processing Statements]]
	</noinclude>		</noinclude>

Laura: Created page with "The '''NxtFld''' statement works the same way as Curfld except that it takes into account the way the field was exited and reports the number of the field that the cur..."

2013-01-23T21:43:14Z

Created page with "The '''NxtFld''' statement works the same way as Curfld except that it takes into account the way the field was exited and reports the number of the field that the cur..."

New page

The '''NxtFld''' [[statement]] works the same way as [[Curfld]] except that it takes into account the way the field was exited and reports the number of the field that the cursor is going to enter next.

====Related Functions====
*[[CurFld]]
*[[CurRow]]
*[[CurCol]]
*[[Input Fields]]
*[[CurPos]]

<noinclude>
[[Category:Statements]]
[[Category:Window File Processing Statements]]
</noinclude>