newpad(3cur)
Name
newpad − create new pad
Syntax
#include <cursesX.h>
WINDOW ∗newpad(nlines, ncols)
int nlines, ncols;
Description
The newpad routine creates a new pad data structure. A pad differs from a window in that it is not restricted by the screen size, and it is not necessarily associated with a particular part of the screen. Pads can be used when large windows are needed. Only part of the pad will be on the screen at any one time.
Automatic refreshes of pads for example, from scrolling or echoing of input, do not occur.
You cannot call the refresh routine with a pad as an argument; use the routines prefresh or pnoutrefresh instead.
Note that these two routines require additional parameters to specify both the part of the pad to be displayed and the screen location for the display.
Return Values
On success the newpad function returns a pointer to the new WINDOW structure created. On failure the function returns a null pointer.