The newpad routine is used to create a new pad.
Syntax |
 |
#include <curses.h>
WINDOW *newpad(int nlines, int ncols);
|
Parameters |
|
- nlines
The number of lines in the window.
- ncols
The number of columns in the window.
Return Values |
|
On success, a pointer to the new window structure is returned; otherwise, a null pointer is returned.
Description |
|
The newpad() routine creates a new pad with the specified number of lines and columns. A pointer to the new pad structure is returned. A pad differs from a window in that it is not restricted to the size of the physical screen. It is useful when only part of a large window will be displayed at any one time.
Automatic refreshes by scrolling or echoing of input do not take place when pads are used. Pads have their own refresh commands, prefresh() and pnoutrefresh(). These contain additional parameters for specifying what part of the pad to display and where to display it on the screen.
Implementation Considerations |
|
Identical to XPG/3
See Also |
|
pnoutrefresh(), prefresh()
Portability |
|
HP-UX, UNIX System V, XPG/3
