Pad management functions
Curses Library (libcurses.a)
#include <curses.h> WINDOW *newpad (int nlines, int ncols); int pnoutrefresh (WINDOW *pad, int pminrow, int pmincol, int sminrow, int smincol, int smaxrorw, int smaxcol); int prefresh (WINDOW *pad, int pminrow, int pmincol, int sminrow, int smincol, int smaxrorw, int smaxcol); WINDOW *subpad (WINDOW *orig, int nlines, int ncols, int begin_y, int begin_x);
The newpad subroutine creates a specialised WINDOW data structure with nlines lines and ncols columns. A pad is similar to a window, except that it is not associated with a viewable part of the screen. Automatic refreshes of pads do not occur.
The subpad subroutine creates a subwindow within a pad with nlines lines and ncols columns. Unlike the subwin subroutine, which uses screen coordinates, the window is at a 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 affects both windows.
The prefresh (prefresh or pnoutrefresh Subroutine) or pnoutrefresh (prefresh or pnoutrefresh Subroutine) subroutines are analogous to the wrefresh and wnoutrefresh subroutines except that they relate to pads instead of windows. The additional arguments indicate what part of the pad and screen are involved. The pminrow and pmincol arguments specify the origin of the rectangle to be displayed in the screen. The lower right-hand corner of the rectangle to be displayed in the pad is calculated from the screen coordinates, since the rectangles must be the same size. Both rectangles must be entirely contained within their respective structures. Negative values of pminrow, pmincol, sminrow or smincol are treated as if they were zero.
Upon successful completion, the newpad and subpad subroutines return a pointer to the pad structure. Otherwise, they return a null pointer.
Upon successful completion, the pnoutrefresh and prefresh subroutines return OK. Otherwise, they return ERR.
For the newpad subroutine:
WINDOW *my_pad; my_pad = newpad(5, 10);
my_pad is now a pad 5 lines deep, 10 columns wide.
WINDOW *my_pad; my_pad = newpad(5, 0);
my_pad is now a pad 5 lines deep, extending to the far right side of the terminal.
WINDOW *my_pad; my_pad = newpad(0, 0);
my_pad is now a pad that fills the entire terminal.
WINDOW *my_pad; my_pal = newpad(120,120); prefresh (my_pal, 0,0,0,0,20,30);
This causes the first 21 rows and first 31 columns of the pad to be displayed on the screen. The upper left coordinates of the resulting rectangle are (0,0) and the bottom right coordinates are (20,30).
For the prefresh or pnoutrefresh subroutines:
WINDOW *my_pad; prefresh(my_pad, 0, 0, 20, 10, 30, 25);
WINDOW *my_pad1; *my_pad2; pnoutrefresh(my_pad1, 0, 0, 20, 10, 30, 25); pnoutrefresh(my_pad2, 0, 0, 0, 0, 10, 5); doupdate();
For the subpad subroutine:
To create a subpad, use:
WINDOW *orig, *mypad; orig = newpad(100, 200); mypad = subpad(orig, 30, 5, 25, 180);
The parent pad is 100 lines by 200 columns. The subpad is 30 lines by 5 columns and starts in line 25, column 180 of the parent pad.
This subroutine is part of Base Operating System (BOS) Runtime.
The derwin (derwin, newwin, or subwin Subroutine) subroutine, doupdate (doupdate, refresh, wnoutrefresh, or wrefresh Subroutines) subroutine, is_linetouched (is_linetouched, is_wintouched, touchline, touchwin, untouchwin, or wtouchin Subroutine) subroutine, prefresh (prefresh or pnoutrefresh Subroutine) or pnoutrefresh (prefresh or pnoutrefresh Subroutine) subroutine, and subpad (subpad Subroutine) subroutine.
Curses Overview for Programming in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.
List of Curses Subroutines in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.
Windows in the Curses Environment in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.