180 lines
9.3 KiB
HTML
180 lines
9.3 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="WDWTITLE (Window Title) keyword for display files" />
|
|
<meta name="abstract" content="Use this record-level keyword to specify the text, color, and display attributes for a title that will be imbedded within the top or bottom border of a window." />
|
|
<meta name="description" content="Use this record-level keyword to specify the text, color, and display attributes for a title that will be imbedded within the top or bottom border of a window." />
|
|
<meta name="DC.subject" content="window, title, WDWTITLE (Window Title) keyword, Window Title (WDWTITLE) keyword" />
|
|
<meta name="keywords" content="window, title, WDWTITLE (Window Title) keyword, Window Title (WDWTITLE) keyword" />
|
|
<meta name="DC.Relation" scheme="URI" content="rzakcmstkeyent.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="rzakcmstwdwtit" />
|
|
<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>WDWTITLE (Window Title) keyword for display files</title>
|
|
</head>
|
|
<body id="rzakcmstwdwtit"><a name="rzakcmstwdwtit"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">WDWTITLE (Window Title) keyword for display files</h1>
|
|
<div><p>Use this record-level keyword to specify the text, color, and display
|
|
attributes for a title that will be imbedded within the top or bottom border
|
|
of a window.</p>
|
|
<div class="section"><div class="p">The format of the keyword is: <pre>WDWTITLE([title-text] [title-text-color]
|
|
[title-text-display-attribute]
|
|
[*CENTER | *LEFT | *RIGHT]
|
|
[*TOP | *BOTTOM])</pre>
|
|
</div>
|
|
<p>At least one parameter must be specified.</p>
|
|
<div class="p">The
|
|
title-text parameter is an optional parameter which specifies the text that
|
|
will be placed in the border of the window. The length of the text should
|
|
be less than or equal to the window-positions parameter of the associated
|
|
WINDOW definition record. If blanks are placed at the beginning of the text
|
|
string, the title will be shortened so there are a equal number of blanks
|
|
at the end. If the text string is too long (> window-positions), it will
|
|
be truncated on the right. The parameter is specified as an expression of
|
|
the form (*TEXT value) where <strong>value</strong> can be specified in one of two forms:
|
|
<ul><li>As a character string: 'Title text '</li>
|
|
<li>As a program-to-system field: &field-name</li>
|
|
</ul>
|
|
</div>
|
|
<p>The field-name specified must exist in the window record and must
|
|
be defined as a character field with usage P.</p>
|
|
<div class="note"><span class="notetitle">Notes:</span> <ol><li>A GRAPHIC literal should not be used for the title-text parameter.</li>
|
|
<li>If the title characters are blanks, then a blank title will be displayed.</li>
|
|
<li>If the title characters are nulls, then no title will be displayed.</li>
|
|
</ol>
|
|
</div>
|
|
<p>The title-text-color specifies the color of the title text
|
|
on a color display. The parameter is specified as an expression of the form
|
|
(*COLOR value).</p>
|
|
<div class="p">The valid values for the title-text-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">WHT</dt>
|
|
<dd>White</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">PNK</dt>
|
|
<dd>Pink</dd>
|
|
</dl>
|
|
</div>
|
|
<p>If the title-text-color parameter is not specified,
|
|
it is set to the color of the border as default. The parameter is ignored
|
|
if it is specified for a window on a noncolor display.</p>
|
|
<p>The
|
|
title-text-display-attribute specifies the display attributes of the title
|
|
text. The parameter is specified as an expression in the form (<var class="varname">*DSPATR
|
|
[value1 [value2 [value3...]]]</var>). If more than one DSPATR is used,
|
|
they are combined to form one DSPATR that is used for the title text.</p>
|
|
<div class="p">The
|
|
valid values for the title-text-display-attribute values are: <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>
|
|
</div>
|
|
<p>If the title-text-display-attribute
|
|
parameter is not specified, it is set to the text attribute of the border
|
|
as default.</p>
|
|
<p>If neither the title-text-color nor title-text-display-attribute
|
|
parameter is specified, the window border will flow up to the first character
|
|
of the window title and resume immediately after the last character. If either
|
|
parameter is specified, there will be a space immediately before and after
|
|
the window title.</p>
|
|
<p>The *CENTER/*LEFT/*RIGHT parameter specifies whether
|
|
the window title should be aligned to the CENTER, LEFT or RIGHT of the window
|
|
border. If not specified, the window title will be aligned in the CENTER of
|
|
the window border if the next parameter is *TOP or to the LEFT of the window
|
|
border if the next parameter is *BOTTOM.</p>
|
|
<div class="note"><span class="notetitle">Note:</span> Not all controllers support
|
|
alignment, on those controllers the title will be centered.</div>
|
|
<p>The *TOP/*BOTTOM
|
|
parameter specifies if the text should be imbedded in the top or bottom border.
|
|
If not specified, the text will be placed in the top border.</p>
|
|
<div class="note"><span class="notetitle">Note:</span> If *BOTTOM
|
|
is specified on an enhanced controller that does not support text in the bottom
|
|
windows border, this keyword will be ignored.</div>
|
|
<div class="note"><span class="notetitle">Note:</span> Specifying ENHDSP(*NO)
|
|
on the CRTDSPF or CHGDSPF command allows *BOTTOM, *LEFT, and *RIGHT to always
|
|
work; however, all the other enhanced user interface functions will be lost.</div>
|
|
<p>Option
|
|
indicators are valid for this keyword.</p>
|
|
<p>The WDWTITLE keyword can only
|
|
be specified on a record that contains a WINDOW keyword (in the definition
|
|
format). If a WINDOW keyword that references another window is also specified,
|
|
a warning message is issued.</p>
|
|
<p>You can specify more than one WDWTITLE
|
|
on a record. If you specify the WDWTITLE keyword more than once at the record
|
|
level, the parameters for the keywords that are in effect are combined. If
|
|
different values are specified for the same parameter, the parameter value
|
|
of the first keyword is used.</p>
|
|
</div>
|
|
<div class="example"><h4 class="sectiontitle">Example</h4><p>The following example shows how to specify
|
|
the WDWTITLE keyword.</p>
|
|
<pre>|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
|
|
A
|
|
A R RECORD1 WINDOW(6 15 9 30)
|
|
A N01 WDWTITLE((*TEXT &TTL1) (*COLOR GRN))
|
|
A 01 WDWTITLE((*TEXT &TTL1) (*COLOR RED))
|
|
A FIELD1 5A B 2 2
|
|
A FIELD2 20A B 8 5
|
|
A TTL1 10A P
|
|
A
|
|
A R RECORD2 WINDOW(8 20 9 30)
|
|
A WDWTITLE((*TEXT &TTL2) +
|
|
A (*COLOR YLW) +
|
|
A (*DSPATR RI))
|
|
A FIELD3 5A B 2 2
|
|
A FIELD4 20A B 8 5
|
|
A TTL2 10A P
|
|
A</pre>
|
|
<p>If the window defined by RECORD1 is written to the display,
|
|
it will have whatever text is contained within TTL1 imbedded within the top
|
|
border of the window. If indicator 01 is set off, this text will be green.
|
|
If indicator 01 is set on, the text will be red.</p>
|
|
<p>When the window defined
|
|
by RECORD2 is written to the display, the text contained within TTL2 will
|
|
be imbedded within the top border of the window. This text will be display
|
|
in reverse image and yellow.</p>
|
|
</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>
|
|
</body>
|
|
</html> |