$Screen_mod

From m204wiki
Revision as of 18:40, 1 June 2017 by ELowell (talk | contribs) (→‎Syntax)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Set modified attribute in screen item

This function sets the modified attribute for a screen item. 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 setting a screen item from the external source, set the screen item's modified attribute so that the legacy code can tell that the item has changed.

Under Model 204 7.8 and later, $Screen_mod is callable.

Syntax

[%one =] $Screen_mod(scr_item)

Syntax terms

%one This function always returns 1.
scr_item The screen item for which attributes are to be returned.
This can be a variable of the form %screen:item or a screen item name variable of the form :%string.

Example

This code fragment sets the modified attribute for screen item bar in screen foo:

%rc = $Screen_mod(%foo:bar)