WINDOW Statement
opens a display window
- WINDOW <CLOSE=>window-name
<window-options>
- <GROUP=group-name
field-specs>
- < ...GROUP=group-name
field-specs>;
where the arguments and options are described below.
The WINDOW statement defines a window on the
display and can include a number of fields.
The DISPLAY statement actually writes values to the window.
The following fields can be specified in the WINDOW statement:
- window-name
- specifies a name 1 to 8 characters long for the window.
This name is displayed in the upper-left border of the window.
- CLOSE=window-name
- closes the window.
- window-options
- control the size, position, and other attributes of the window.
The attributes can also be changed interactively with
window commands such as WGROW, WDEF, WSHRINK, and COLOR.
A description of the window options follows.
- GROUP=group-name
- starts a repeating sequence of groups
of fields defined for the window.
The group-name specification is a name
1 to 8 characters long used to identify a
group of fields in a later DISPLAY statement.
- field-specs
- are a sequence of field specifications made up of
positionals, field operands, formats, and options.
These are described in the next section.
The following window options can be
specified in the WINDOW statement:
- CMNDLINE=name
- specifies the name of a variable in which the
command line entered by the user will be stored.
- COLOR=operand
- specifies the background color for the window.
The operand is either a quoted
character literal, a name, or an operand.
The valid values are "WHITE", "BLACK", "GREEN",
"MAGENTA", "RED", "YELLOW", "CYAN", "GRAY", and "BLUE".
The default value is BLACK.
- COLUMNS=operand
- specifies the starting number of columns for the window.
The operand is either a literal number, a
variable name, or an expression in parentheses.
The default value is 78 columns.
- ICOLUMN=operand
- specifies the initial starting column
position of the window on the display.
The operand is either a literal number or a variable name.
The default value is column 1.
- IROW=operand
- specifies the initial starting row
position of the window on the display.
The operand is either a literal number or a variable name.
The default value is row 1.
- MSGLINE=operand
- specifies the message to be displayed on the
standard message line when the window is made active.
The operand is almost always the name of
a variable, but a character literal can be used.
- ROWS=operand
- determines the starting number of rows of the window.
The operand is either a literal number,
the name of a variable containing the number, or
an expression in parentheses yielding the number.
The default value is 23 rows.
Both the WINDOW and DISPLAY statements allow
field specifications, which have the general form:
- <positionals> field-operand <format>
<field-options>
In the statement above,
- positionals
- are directives determining the position
on the screen to begin the field.
There are four kinds of positionals; any number
of positionals are allowed for each field operand.
- # operand
- specifies the row position; that is, it moves the
current position to column 1 of the specified line.
The operand is either a number,
a name, or an expression in parentheses.
- /
- specifies that the current position
move to column 1 of the next row.
- @ operand
- specifies the column position.
The operand is either a number,
a name, or an expression in parentheses.
The @ directive should come after
the # position if # is specified.
- + operand
- specifies a skip of columns.
The operand is either a number, a
name, or an expression in parentheses.
- field-operand
- is a character literal in quotes or the name of a
variable that specifies what is to go in the field.
- format
- is the format used for display, the value,
and the informat applied to entered values.
If no format is specified, then the standard
numeric or character format is used.
- field-options
- specify the attributes of the field as follows:
- PROTECT=YES
- P=YES
- specifies that the field is protected; that
is, you cannot enter values in the field.
If the field operand is a literal, it is already protected.
- COLOR=operand
- specifies the color of the field.
The operand is a literal character value in
quotes, a variable name, or an expression in parentheses.
The colors available are "WHITE", "BLACK", "GREEN",
"MAGENTA", "RED", "YELLOW", "CYAN", "GRAY", and "BLUE".
Note that the color specification is different from
that of the corresponding DATA step value because
it is an operand rather than a name without quotes.
The default value is "BLUE".
Copyright © 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.
