$Screen clear: Difference between revisions
No edit summary |
(→Syntax) |
||
| Line 8: | Line 8: | ||
Under Model 204 7.8 and later, $Screen_clear is [[Calling Sirius Mods $functions|callable]]. | Under Model 204 7.8 and later, $Screen_clear is [[Calling Sirius Mods $functions|callable]]. | ||
==Syntax== | ==Syntax== | ||
<p class="syntax">[%one =] $Screen_clear(< | <p class="syntax">[<span class="term">%one</span> =] $Screen_clear(<span class="term">scr_item</span>, [<span class="term">MOD</span>|<span class="term">TAG</span>]) | ||
</p> | </p> | ||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr | <tr><th>%one</th> | ||
<td>This function always returns 1.</td></tr> | <td>This function always returns 1.</td></tr> | ||
<tr><th>scr_item</th> | <tr><th>scr_item</th> | ||
<td>The screen item in the screen for which attributes are to be cleared. This can be a variable of the form | <td>The screen item in the screen for which attributes are to be cleared. This can be a variable of the form <var class="term">%screen:item</var> or a [[Full-screen feature#Screen_item_name_variables|screen item name variable]] of the form <var class="term">:%string</var>.</td></tr> | ||
<tr | <tr><th>MOD or TAG</th> | ||
<td>Indicates the attributes to be cleared: < | <td>Indicates the attributes to be cleared: <var class="term">MOD</var> clears only the modified attributes and <var class="term">TAG</var> clears only the tagged attributes. If any other value is specified, including no value, both modified and tagged attributes are cleared. | ||
</table> | </table> | ||
Revision as of 18:54, 1 June 2017
Clear tagged and/or modified attributes in a screen
This function clears the tagged and/or modified attributes for all items in a screen. While it might be useful in some normal full-screen applications, it is probably most useful in applications that receive output from a non-full-screen source but populate a screen from that source, in order to be able to use legacy full-screen code.
When the legacy code has produced an updated version of the screen, the code communicating with the external source should probably clear the tagged and/or modified bits, just as a Read Screen statement would.
Under Model 204 7.8 and later, $Screen_clear is callable.
Syntax
[%one =] $Screen_clear(scr_item, [MOD|TAG])
Syntax terms
| %one | This function always returns 1. |
|---|---|
| scr_item | The screen item in the screen for which attributes are to be cleared. This can be a variable of the form %screen:item or a screen item name variable of the form :%string. |
| MOD or TAG | Indicates the attributes to be cleared: MOD clears only the modified attributes and TAG clears only the tagged attributes. If any other value is specified, including no value, both modified and tagged attributes are cleared. |
Example
This code fragment clears the modified attribute for screen foo (which contains screen item bar):
%rc = $screen_clear(%foo:bar, "MOD")