HP 3000 Manuals

MPE/iX Developer's Kit Reference Manual Volume II

newwin 

The newwin routine is used to create a window.

Syntax 

     #include <curses.h>

     WINDOW *newwin(int nlines, int ncols, int begin_y, int begin_x);

Parameters 

nlines                The number of lines in the new window.

ncols                 The number of columns in the new window.

begin_y               The y (row) coordinate of the position of the upper
                      left corner of window.

begin_x               The x (column) coordinate of the position of the
                      upper left corner of the window.

Return Values 

On success, pointer to new window structure is returned; otherwise, a
null pointer is returned.

Description 

The newwin() routine creates a new window with the specified number of
lines and columns and upper left corner positioned at begin_x, begin_y.
A pointer to the new window structure is returned.  A full-screen window
can be created by calling newwin(0,0,0,0).

If the number of lines specified is zero, newwin() uses the default LINES
minus begin_y; if the number of columns specified is zero, newwin() uses
the default COLS minus begin_x.


NOTE  The newwin() routine is a macro.


Implementation Considerations 

Identical to XPG/3

See Also 

delwin(), derwin(), dupwin(), mvwin(), subwin(), touchwin()

Portability 

HP-UX, UNIX System V, XPG/3

MPE/iX 5.0 Documentation