Chapter Contents
Chapter Contents
Previous
Previous
Next
Next
Language Reference

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".

Chapter Contents
Chapter Contents
Previous
Previous
Next
Next
Top
Top

Copyright © 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.