HP 3000 Manuals HP 3000 Manuals
subwin
The subwin routine is used to create a subwindow relative to the physical
screen.
Syntax
#include <curses.h>
WINDOW *subwin(WINDOW *orig, int nlines, int ncols, int begin_y,
int begin_x);
Parameters
orig The parent window of the subwindow.
nlines The number of lines in the subwindow.
ncols The number of columns in the subwindow
begin_y The y (row) coordinate of the upper-left corner of
the window.
begin_x The x (column) coordinate of the upper-left corner
of the window.
Return Values
On success, a pointer to the new window structure is returned; otherwise,
a null pointer is returned.
Description
The subwin() routine creates a subwindow within window orig, with the
specified number of lines and columns, and upper left corner positioned
at begin_x, begin_y (relative to the physical screen, not to window
orig). A pointer to the new window structure is returned.
The original window and subwindow share character storage of the
overlapping area. (Each window maintains its own pointers, cursor
location, and other items.) This means that characters and attributes
are identical in overlapping areas regardless of which window characters
are written to.
When using subwindows, it is often necessary to call touchwin() before
wrefresh() to maintain proper screen contents.
NOTE The derwin() routine creates a subwindow in exactly the same way,
but allows you to specify coordinates relative to window orig.
Implementation Considerations
Identical to XPG/3
See Also
newwin(), touchwin(), derwin()
Portability
HP-UX, UNIX System V, XPG/3