$Screen clear: Difference between revisions
Jump to navigation
Jump to search
(Created page with "{{DISPLAYTITLE:$Screen_clear}} <span class="pageSubtitle">Clear tagged and/or modified attributes in a screen</span> This function clears the tagged and/or modified attribute...") |
(→Syntax) |
||
| Line 6: | Line 6: | ||
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(scr_item, [ | <p class="syntax">[%one =] $Screen_clear(<I>scr_item</I>, [MOD|TAG]) | ||
</p> | </p> | ||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>%one</th> | <tr class="head"><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 <i>%screen:item</i> or a [[Full-screen feature#Screen_item_name_variables|screen item name variable]] of the form <i>:%string</i>.</td></tr> | <td>The screen item in the screen for which attributes are to be cleared. This can be a variable of the form <i>%screen:item</i> or a [[Full-screen feature#Screen_item_name_variables|screen item name variable]] of the form <i>:%string</i>.</td></tr> | ||
<tr><th> | <tr class="head"><th>MOD or TAG</th> | ||
<td>Indicates the attributes to be cleared | <td>Indicates the attributes to be cleared: <code>MOD</code> clears only the modified attributes and <code>TAG</code> 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 00:23, 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 would probably want to 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.
|
Examples
- This code fragment clears the modified attribute for screen
foo(which contains screen itembar):%rc = $screen_clear(%foo:bar, "MOD")