Read (Screen function): Difference between revisions
Jump to navigation
Jump to search
m (1 revision) |
m (match syntax table to syntax template; edits, tags and links) |
||
| Line 1: | Line 1: | ||
{{Template:Screen:Read subtitle}} | {{Template:Screen:Read subtitle}} | ||
The <var>Read</var> <var>[[Notation_conventions_for_methods#Callable_methods|Callable-function]]</var> does the actual write of the screen to the "terminal," and it invokes a <var class="product">Model 204</var> 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 <var>ScreenField</var> objects. | |||
==Syntax== | ==Syntax== | ||
{{Template:Screen:Read syntax}} | {{Template:Screen:Read syntax}} | ||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>%key</th> | <tr><th><var>%key</var></th> | ||
<td>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. </td></tr> | <td>A declared <var>[[ActionKey_enumeration#ActionKey_enumeration|actionKey enumeration]]</var> set to the identifier of the key that activated the reading of the screen. Valid values (case unimportant) are <code>Enter</code> and <code>pf1</code>, <code>pf2</code>, and so on through <code>pf24</code>. </td></tr> | ||
<tr><th> | <tr><th><var>screen</var></th> | ||
<td>A reference to an instance of a Screen object.</td></tr> | <td>A reference to an instance of a <var>Screen</var> object.</td></tr> | ||
</table> | </table> | ||
==Usage notes== | ==Usage notes== | ||
<ul><li>The <var>[[Modified_(ScreenField_property)|Modified]]</var> property is reset for all non-protected <var>ScreenFields</var> after the <var>Read</var> method is invoked. If a particular <var>ScreenField</var> value has been modified by the user, the <var>Modified</var> property for that field is set to <code>True</code>. Otherwise, the <var>Modified</var> property is set to <code>False</code>. | |||
</ul> | |||
==Examples== | |||
For an example using the Read method, see [[Screen Object Sample Code]]. | |||
==See also== | ==See also== | ||
{{Template:Screen:Read footer}} | {{Template:Screen:Read footer}} | ||
Revision as of 06:46, 26 June 2011
Write screen to display and return response (Screen class)
The Read 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.
Syntax
[%key =] screen:Read Throws ScreenReadError
Syntax terms
| %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 toFalse.
Examples
For an example using the Read method, see Screen Object Sample Code.