NAME
subpad — enhanced pad management function
SYNOPSIS
#include <curses.h>
WINDOW *subpad(WINDOW *orig, int nlines, int ncols, int begin_y,
int begin_x);
DESCRIPTION
The
subpad()
function creates a subwindow within a pad with nlines lines and
ncols columns. Unlike
subwin(),
which uses screen coordinates, the window is at position (begin_y,
begin_x) on the pad. The window is made in the middle of the window
orig, so that changes made to one window affect both windows.
RETURN VALUE
subpad()
function returns a pointer to the pad data structure. Otherwise, it returns
a null pointer.
ERRORS
No errors are defined.
APPLICATION USAGE
To refresh a pad, call
prefresh()
or
pnoutrefresh(),
not
wrefresh().
When porting code to use pads from WINDOWS, remember that these functions
require additional arguments to specify the part of the pad to be displayed
and the location on the screen to be used for the display.
Although a subwindow and its parent pad may share memory representing
characters in the pad, they need not share status information about what has
changed in the pad. Therefore, after modifying a subwindow within a pad, it
may be necessary to call
touchwin()
or
touchline()
on the pad before calling
prefresh().
CHANGE HISTORY
First released in X/Open Curses, Issue 4.