The IfScreen tag allows simple logic based on the value of an area of the active screen buffer.
The logic of the IfScreen tag is: if the text attribute matches the contents of the screen found at row/column then the condition is TRUE.
Session Scratch Area
There is a 4000 character "scratch area" for each session that is initialized to nulls at the start of each session. You can write to the scratch area using the PutScreen tag and read it with IfScreen by specifying a row number that is negative. The scratch area is not affected by any screen read/write operations so the contents will remain throughout a session. This allows you to use the scratch area as a storage area for variable data.
The IfScreen tag's attributes are as follows:
Attribute |
Default / Required |
Description |
row |
1 |
Row number (1..maximum rows) -- to access the scratch area contents, use a negative number for row number, such as -1. |
column |
1 |
Column number (1..maximum columns) |
text |
required |
Text to compare, blanks are used |
caseSensitive |
no |
If yes, the comparison is case sensitive. |
Child Tags Allowed:
Example:
<IfScreen row="12" column="21" text="user1">
<IfScreen row="13" column="21" text="pass1">
<ScreenSwitch screen="MainMenu"/>
<Else/>
<PutScreen row="12" column="31" text="}Password wrong]"/>
</IfScreen>
<Else/>
<PutScreen row="12" column="31" text="}UserID wrong]"/>
</IfScreen>
