subwin(3cur)
Name
subwin − create subwindow
Syntax
#include <cursesX.h>
WINDOW ∗subwin(orig, nlines, ncols, begin_y, begin_x)
WINDOW ∗orig;
int nlines, ncols, begin_y, begin_x;
Description
This routine creates a new sub-window within a window. The dimensions of the sub-window are nlines lines and ncols columns. The sub-window is at position ( begin_y, begin_x) on the screen. This position is relative to the screen, and not to the window orig.
The sub-window is made in the middle of the window orig, so that changes made to either window will affect both. When using this routine, it will often be necessary to call touchwin before calling wrefresh.
Return Value
On success the subwin function returns a pointer to the new WINDOW structure created. On failure the function returns a null pointer.
Errors
No errors are defined for this function.