ENHANCED CURSES

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(). 

SEE ALSO

derwin(), doupdate(), is_linetouched(), newpad(), <curses.h>. 

CHANGE HISTORY

First released in X/Open Curses, Issue 4. 

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996