IOCancelMode Method (BUTTON)

PLBCMP GUI Only, 9.6A

The IOCancelMethod method sets the state for a BUTTON object to allow a click action to cancel a FILE, AFILE, or IFILE READ that is active. This method uses the following format:

[label]	{object}.IOCancelMode	[GIVING {return}]:
		USING [Value=]{value*}

Where:

label

Optional. A Program Execution Label.

object

Required. A Button that has been created.

return

Optional. A Numeric Variable that is always zero.

value

Required. A Numeric Variable or decimal value that specifies the new state of the BUTTON.

Flags Affected: OVER, ZERO

Note the following:

The ZERO (EQUAL) Condition Flag is always set
The OVER Condition Flag is always cleared.
If the {value} is a zero, the BUTTON is reset to not cancel an AFILE read. If the {value} is non-zero, the BUTTON will cancel an AFILE read on a click action.
This method replaces the AamCancelMode method that is now obsolete.

See Also: Button Methods, Method Syntax