View source for $CHKSFLD

<p>Use the $CHKSFLD function to determine whether a display attribute is applied to a screen item for a specified type of screen processing.</p>
<b>Syntax</b>
<p class="code">$CHKSFLD(screen-name,item-name,display-attribute,

        [process-type])
</p>
<b>Where</b>
<ul>
<li>Both the screen-name and item-name arguments are expected to be string expressions and can include quoted strings, %variables, field names, or functions. </li>
</li>
<li>display-attribute value can be one of the following:</li>
<table>
<tr class="head">
<th>Value</th>
<th>Meaning</th>
</tr>
<tr>
<td>'ASK'</td>
<td>Auto-skip</td>
</tr>
<tr>
<td>'BLI'</td>
<td>Blink</td>
</tr>
<tr>
<td>'BLU'</td>
<td>Blue color</td>
</tr>
<tr>
<td>'BRI'</td>
<td>Bright</td>
</tr>
<tr>
<td>'DEF'</td>
<td>Default color</td>
</tr>
<tr>
<td>'GRE'</td>
<td>Green color</td>
</tr>
<tr>
<td>'INV'</td>
<td>Invisible</td>
</tr>
<tr>
<td>'NUM'</td>
<td>Numeric field</td>
</tr>
<tr>
<td>'PIN'</td>
<td>Pink color</td>
</tr>
<tr>
<td>'PRO'</td>
<td>Protected</td>
</tr>
<tr>
<td>'RED'</td>
<td>Red color</td>
</tr>
<tr>
<td>'REV'</td>
<td>Reverse image</td>
</tr>
<tr>
<td>'TUR'</td>
<td>Turquoise color</td>
</tr>
<tr>
<td>'USC'</td>
<td>Underscore</td>
</tr>
<tr>
<td>'WHI'</td>
<td>White color</td>
</tr>
<tr>
<td>'YEL'</td>
<td>Yellow color</td>
</tr>
</table>
</li>
<li>process-type can be one of the following:</li>
</li>
</ul>
<p>'PRINT'</p>
<p>'READ' (the default)</p>
<p>'REREAD'</p>
<p>'TAG'</p>
<b>Returns</b>
<ul>
<li>1 if the attribute is ON for the type specified.</li>
</li>
<li>0 if the attribute is OFF for the type specified.</li>
</li>
</ul>
<b>Usage</b>
<p>For example, if you want to check whether the POLNO (policy number) field in the screen MAIN is displayed in blue in reread processing, enter the following command:</p>
<p class="code">BEGIN
SCREEN MAIN
INPUT POLNO AT 10 LEN 20 RED
END SCREEN
MODIFY %MAIN:POLNO TO BLUE FOR REREAD
PRINT $CHKSFLD('MAIN','POLNO','BLU','REREAD')
END
</p>
<p>Produces the following output:</p>
<p class="code">1
</p>
<b>Nonfatal errors</b>
<p>If you do not specify colors within the <var class="product">Model&nbsp;204</var> screen definition, the color displayed on your terminal is the default color display. For example, you might be looking at a pink display, but when you invoke the $CHKSFLD function, checking for 'PIN' does not return a '1' because pink was not assigned by the <var class="product">Model&nbsp;204</var> screen definition. </p>
<p>The following messages might be issued:</p>
<p class="code">M204.2462: INVALID ATTRIBUTE SPECIFIED: attribute

M204.2462: INVALID ATTR.TYPE SPECIFIED: attr.TYPE

M204.0329: SCREEN OR IMAGE ITEM NAME NOT FOUND: name

M204.0324: SCREEN, MENU, OR IMAGE NAME NOT DEFINED: name  

M204.0247: SCREEN, MENU, OR IMAGE NAME NOT SPECIFIED
</p>
[[Category:SOUL $functions]]