ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakc_5.4.0.1/rzakcmstchcava.htm

168 lines
9.4 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="reference" />
<meta name="DC.Title" content="CHCAVAIL (Choice Color/Display Attribute when Available) keyword for display files" />
<meta name="abstract" content="Use this field-level keyword to specify the color or display attributes to be used when displaying the available choices in a menu bar, push button, selection field, or subfile single or multiple choice selection list." />
<meta name="description" content="Use this field-level keyword to specify the color or display attributes to be used when displaying the available choices in a menu bar, push button, selection field, or subfile single or multiple choice selection list." />
<meta name="DC.subject" content="CHCAVAIL (Choice Color/Display Attributes when Available) keyword, Choice Color/Display Attributes when Available (CHCAVAIL) keyword, specifying, color/display attributes available" />
<meta name="keywords" content="CHCAVAIL (Choice Color/Display Attributes when Available) keyword, Choice Color/Display Attributes when Available (CHCAVAIL) keyword, specifying, color/display attributes available" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfsflml.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakcmstdfcolor.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2001, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2001, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzakcmstchcava" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>CHCAVAIL (Choice Color/Display Attribute when Available) keyword for
display files</title>
</head>
<body id="rzakcmstchcava"><a name="rzakcmstchcava"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">CHCAVAIL (Choice Color/Display Attribute when Available) keyword for
display files</h1>
<div><p>Use this field-level keyword to specify the color or display attributes
to be used when displaying the available choices in a menu bar, push button,
selection field, or subfile single or multiple choice selection list.</p>
<div class="section"><div class="p">The format of the keyword is: <pre>CHCAVAIL([color] [display-attributes])</pre>
</div>
<p>One
parameter must be specified.</p>
<div class="p">The color parameter indicates the color
of the choice text for a field on a color workstation. The choice text can
be specified on the following keywords: <ul><li>MNUBARCHC</li>
<li>CHOICE</li>
<li>PSHBTNCHC</li>
</ul>
</div>
<p>The choice text can also come from the text displayed for a subfile
used as a single choice or multiple choice selection list. The parameter is
specified as an expression of the form (*COLOR value).</p>
<div class="p">The valid values
for the color parameter are: <dl><dt><strong>Value</strong></dt>
<dd><strong>Meaning</strong></dd>
<dt class="dlterm">BLU</dt>
<dd>Blue</dd>
<dt class="dlterm">GRN</dt>
<dd>Green</dd>
<dt class="dlterm">PNK</dt>
<dd>Pink</dd>
<dt class="dlterm">RED</dt>
<dd>Red</dd>
<dt class="dlterm">TRQ</dt>
<dd>Turquoise</dd>
<dt class="dlterm">YLW</dt>
<dd>Yellow</dd>
<dt class="dlterm">WHT</dt>
<dd>White</dd>
</dl>
</div>
<p>If the color parameter is not specified, the default
color for the available choices in a menu bar is green. The default color
for the available choices in a selection field is green. This parameter is
ignored on a monochrome workstation.</p>
<p>The display-attribute
parameter indicates the display attributes of the choice text specified on
the MNUBARCHC or CHOICE keyword for the field. The parameter is specified
as an expression of the form (<var class="varname">*DSPATR value1 &lt;value2 &lt;value3...&gt;&gt;</var>).</p>
<p>The
valid values for the display attributes are:</p>
<dl><dt><strong>Value</strong></dt>
<dd><strong>Meaning</strong></dd>
<dt class="dlterm">BL</dt>
<dd>Blink</dd>
<dt class="dlterm">CS</dt>
<dd>Column separator</dd>
<dt class="dlterm">HI</dt>
<dd>High intensity</dd>
<dt class="dlterm">ND</dt>
<dd>Nondisplay</dd>
<dt class="dlterm">RI</dt>
<dd>Reverse image</dd>
<dt class="dlterm">UL</dt>
<dd>Underline</dd>
</dl>
<p>The default display attribute in a menu bar is high intensity.
The default display attribute in a selection field is normal (or low) intensity.</p>
<div class="note"><span class="notetitle">Note:</span> Display
attributes CS, HI, and BL can cause fields on 5292, 3179, 3197 Models C1 and
C2, 3477 Model FC, 3486, 3487 Model HC, and 3488<a href="#rzakcmstchcava__zcolor">1</a> workstations
to appear as color fields. Separator lines do not appear when
display attributes HI, RI, and UL are used.</div>
<p>The CHCAVAIL keyword
is allowed on a field only if the field has one or more PSHBTNCHC, CHOICE,
or MNUBARCHC keywords. It is also allowed on a subfile control record if the
subfile control record uses either the SFLSNGCHC or SFLMLTCHC keywords.</p>
<p>Option
indicators are valid for this keyword.</p>
</div>
<div class="example"><h4 class="sectiontitle">Example 1</h4><p>The following example shows how to specify
the CHCAVAIL keyword. In the example, the choices in the menu bar, if available,
are displayed in yellow on a color display. For a monochrome display, the
menu bar is the default color (green) at high intensity.</p>
<pre>|....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A
A R RECORD MNUBAR
A F1 2Y 0B 1 2
A MNUBARCHC(1 PULLFILE 'File ')
A MNUBARCHC(2 PULLEDIT 'Edit ')
A CHCAVAIL((*COLOR YLW))
A</pre>
</div>
<div class="example"><h4 class="sectiontitle">Example 2</h4><p>In the following example, the available
choices for the selection field are displayed with underlines.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A
A R RECORD
A F1 2Y 0B 2 5SNGCHCFLD CHECK(ER)
A CHOICE(1 'Choice number 1')
A CHOICE(2 'Choice number 2')
A CHCCTL(1 &amp;CHCCTL1);
A CHCCTL(2 &amp;CHCCTL2);
A CHCAVAIL((*DSPATR UL))
A</pre>
</div>
<div class="example"><h4 class="sectiontitle">Example 3</h4><p>In the following example, the single choice
selection list is displayed in yellow on a color display. The available choices
are also underlined.</p>
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
A R SFLREC SFL
A CTLFLD 1Y 0H SFLCHCCTL
A R SFLCTLRCD SFLCTL(SFLREC)
A SFLSNGCHC
A :
A :
A CHOICE(1 'Choice number 1')
A :
A :
A CHOICE(2 'Choice number 2')
A :
A :
A CHCAVAIL((*DSPATR UL))
A CHCAVAIL((*COLOR YLW))</pre>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakcmstkeyent.htm" title="You type the keyword entries that define display files in positions 45 through 80 (functions).">DDS keyword entries for display files (positions 45 through 80)</a></div>
</div>
<div class="relref"><strong>Related reference</strong><br />
<div><a href="rzakcmstdfsflml.htm" title="Use this record-level keyword to define a subfile as a multiple-choice-selection list. A multiple-choice-selection list is a scrollable group of items from which the user can select multiple items.">SFLMLTCHC (Subfile Multiple Choice Selection List) keyword for display files</a></div>
<div><a href="rzakcmstdfcolor.htm" title="Use this keyword to specify the color of a field on a color display.">COLOR (Color) keyword for display files</a></div>
</div>
</div><div class="p"><a id="rzakcmstchcava__zcolor"><sup>1</sup></a> Dependent on the monitor attached to the display device.</div>
</body>
</html>