Window size

max_width = integer
max_height = integer

The maximum width and height of the window.

If pixel positioning is being used, the integers represent numbers of pixels. If character positioning is being used, they represent numbers of columns and rows respectively. See Pixel and character positioning.

A window may extend beyond the visible screen. The viewing size of the window may be different from the maximum, but may not be extended beyond the maximum specified. The maximum width and height may be modified at run time.

Note

If a window’s maximum size is decreased, anything which appeared in the area that has been lost is destroyed.

Default: The screen width and the screen height.

In a pixel grid, the default is 80 x 25 characters converted to pixels according the average character size in the window’s data font.

In a character grid, these are normally the values allocated to Screen Size 1 in the terminal parameter file (Section 3). However, this section can be used to store different screen size definitions.

min_width = integer
min_height = integer

The minimum width and height of the window.

If pixel positioning is being used, the integers represent numbers of pixels. If character positioning is being used, they represent numbers of columns and rows respectively. See Pixel and character positioning.

These optional clauses define the minimum width and height to which the viewing area of the window can be reduced. If omitted they default to the values of max_width and max_height respectively. If the minimum and maximum dimensions are identical, the viewing size cannot be altered.

If the min_width differs from the max_width, and the style flag WS_HSCROLL is specified, the window has a horizontal scroll bar. Similarly, if the min_height differs from the max_height, and the style flag WS_VSCROLL is specified, the window has a vertical scroll bar.

Default: The values of max_width and max_height respectively.

view_width = integer
view_height = integer

The actual screen width and height of the window, excluding border and shadow.

If pixel positioning is being used, the integers represent numbers of pixels. If character positioning is being used, they represent numbers of columns and rows respectively. See Pixel and character positioning.

Both these clauses are optional in the window definition. If present, they determine the initial viewing size of the window. Otherwise the initial viewing size is taken from the values of max_width and max_height respectively. The viewing area may not be greater than the maximum width and height, nor less than the minimum. Note therefore that if a viewing size is defined, a minimum size (otherwise optional) must also be defined.

The viewing area of a window may be freely reduced and enlarged at run time, without loss of the data which becomes concealed when the window is reduced.

The user can change the viewing size by dragging the window border, in the usual way, within the minimum and maximum limits.

Default: The values of max_width and max_height respectively.


RELATED TOPICS

Windows