$ScrWide: Difference between revisions
m (Created page with "<span class="pageSubtitle">Allow SCREEN to accept fields wider than 79</span> <p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods....") |
(Automatically generated page update) |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
<span class="pageSubtitle">Allow SCREEN to accept fields wider than 79</span> | <span class="pageSubtitle">Allow SCREEN to accept fields wider than 79</span> | ||
<p class=" | <p class="warn"><b>Note: </b>Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the screen $functions are the [[Screen classes#Screens and ScreenFields|Screen and ScreenField classes]].</p> | ||
This [[Calling Sirius Mods $functions|callable]] function adjusts a <var>SCREEN</var> structure so that it is capable of accommodating | This [[Calling Sirius Mods $functions|callable]] function adjusts a <var>SCREEN</var> structure so that it is capable of accommodating | ||
| Line 46: | Line 46: | ||
<li><var class="product">Sirius Functions</var> | <li><var class="product">Sirius Functions</var> | ||
</ul> | </ul> | ||
[[Category:$Functions|$ScrWide]] | |||
Latest revision as of 22:52, 20 September 2018
Allow SCREEN to accept fields wider than 79
Note: Many $functions have been deprecated in favor of Object Oriented methods. The OO equivalent for the screen $functions are the Screen and ScreenField classes.
This callable function adjusts a SCREEN structure so that it is capable of accommodating fields that are wider than 79 bytes. These "wide" fields can only be displayed on a Model 5 terminal and can be created with the $ScrSize function.
Generally, the $ScrWide function must be preceded by a $ScrHide function if it is used on a Model 5 terminal. This is because the $ScrHide function provides extra space that can be used by the $ScrWide function.
Syntax
[%result =] $ScrWide(scr_name)
Syntax terms
| %result | This numeric value indicates the function result. See "Status codes". |
|---|---|
| scr_name | The name of the screen to be "widened." |
Status codes
0 — No errors 1 — SCREEN does not exist or invalid screen name 2 — Not enough space to widen screen (need $ScrHide)
Examples
- This code fragment makes it possible to create "wide" fields on screen
INPUT:%rc = $ScrWide('INPUT')
Note that the $ScrWide function does not, in itself, change the appearance of a SCREEN. It simply makes it possible to make fields wider than 79 columns with the $ScrSize function on Model 5 terminals.
- See the $ScrHide "Examples" section for a complete example using $ScrHide, $ScrSize, and $ScrWide.
Products authorizing $ScrWide
- Sirius Functions