SAS Component Language Dictionary

WREGION

Defines the boundaries for the next window that is displayed

Category:

Window

Syntax
Details
Examples
See Also

Syntax

CALL WREGION(start-row,start-col,num-rows,num-cols,options);

start-row

is the starting row for the next window.

Type: Numeric

start-col

is the starting column for the next window.

Type: Numeric

num-rows

is the number of rows for the next window.

Type: Numeric

num-cols

is the number of columns for the next window.

Type: Numeric

options

are one or more window attributes that the window's size needs to accommodate:

'': no command line, command menu, or scroll bars
'CMDLINE': a command area
'HSBAR': a horizontal scroll bar
'INNERSIZE': interior size is determined by the values of num-rows and num-cols
'PMENU': a command menu
'VSBAR': a vertical scroll bar

Type: Character

Details

The size of the next window depends on whether it has a command area, a pmenu, and scroll bars. (The command area includes the message line.) By default, WREGION assumes that the next window will have all of these attributes. You can use options to change this assumption. Note that options does not cause the next window to have these attributes. Rather, it helps WREGION determine the correct size.

'INNERSIZE' specifies that the values of num-rows and num-cols will control the interior size of the window. Normally, the num-rows and num-cols control the exterior size of the window (including the borders).

WREGION does not affect the size of subsequent FSEDIT windows that are opened by using CALL FSEDIT. The function cannot resize windows when a SAS/AF or FSEDIT application is called with the NOBORDER option.

Examples

Specify a WREGION for the LEGEND window. Notice that the options argument to WREGION is a null string, designating that none of the display options are used in the LEGEND window. The window size is four rows long: two lines of text plus the top and bottom borders.
```
call wregion(1,1,4,80,'');
call putlegend
   (1,'This is legend line 1','yellow','none');
call putlegend
   (2,'This is legend line 2','yellow','none');
call legend
   ('mylegend window name','','white','reverse');
```
Execute a WREGION function and invoke a PROGRAM entry. The application window for the entry has a command line. However, because scrolling is not necessary, the HBAR and VBAR options are not specified. Only the CMDLINE option is specified.
```
call wregion(1,1,20,80,'cmdline');
call display('another.program',a,b,c);
```