Read (Screen function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
 
Line 1: Line 1:
{{Template:Screen:Read subtitle}}
This callable function does the actual write of the screen to the "terminal," and it invokes a Model 204 wait while the user responds to the displayed screen. It then reads from the terminal the subsequent user response and updates the values of any modified ScreenField objects.
This callable function does the actual write of the screen to the "terminal," and it invokes a Model 204 wait while the user responds to the displayed screen. It then reads from the terminal the subsequent user response and updates the values of any modified ScreenField objects.


Line 19: Line 21:


For an example using the Read method, see [[Screen Object Sample Code]].
For an example using the Read method, see [[Screen Object Sample Code]].
==See also==
{{Template:Screen:Read footer}}

Revision as of 16:58, 16 February 2011

Write screen to display and return response (Screen class)


This callable function does the actual write of the screen to the "terminal," and it invokes a Model 204 wait while the user responds to the displayed screen. It then reads from the terminal the subsequent user response and updates the values of any modified ScreenField objects.

  [%key =] %screen:Read
Read syntax
%key
A declared actionKey enumeration set to the identifier of the key that activated the reading of the screen. Valid values (case unimportant) are Enter and pf1, pf2, and so on through pf24.
%screen
A reference to an instance of a Screen object.
Usage Notes

The Modified property is reset for all non-protected ScreenFields after the Read method is invoked. If a particular ScreenField value has been modified by the user, the Modified property for that field is set to True. Otherwise, the Modified property is set to False.

For an example using the Read method, see Screen Object Sample Code.

See also