 |
» |
|
|
|
The prefresh and pnoutrefresh routines routines are used to copy the pad data structure to a physical window. Syntax | |
#include <curses.h>
int prefresh(WINDOW *pad, int pminrow, int pmincol, int sminrow,
int smincol, int smaxrow, int smaxcol);
int pnoutrefresh(WINDOW *pad, int pminrow, int pmincol, int sminrow,
int smincol, int smaxrow, int smaxcol);
|
Parameters | |
- pad
A pointer to the pad to refresh.
- pmincol
The column coordinate of the upper-left corner
of the pad rectangle to be copied.
- pminrow
The row coordinate of the upper-left corner of
the pad rectangle to be copied
- smincol
The column coordinate of the upper-left corner
of the rectangle on the physical screen where pad
is to be positioned.
- sminrow
The row coordinate of the upper-left corner of
the rectangle on the physical screen where pad is
to be positioned.
- smaxcol
The column coordinate of the lower-right corner
of the rectangle on the physical screen where the
pad is to be positioned.
- smaxrow
The row coordinate of the lower-right corner of
the rectangle on the physical screen where the pad
is to be positioned.
Return Values | |
- OK
Successful completion.
- ERROR
An error occurred.
Description | |
The prefresh() routine copies the specified portion
of the logical pad to the terminal screen. The parameters pmincol and pminrow specify the upper-left corner of the rectangular area of the pad to be
displayed. The lower-right coordinate of the rectangular area of the pad that is to be displayed is calculated from the screen parameters (sminrow, smincol,
smaxrow, and smaxcol). This routine calls the pnoutrefresh() routine to copy
the specified portion of pad to the terminal screen
and the doupdate() routine to do the actual update.
The logical cursor is copied to the same location in
the physical window unless leavok() is enabled (in
which case, the cursor is placed in a position that
the program finds convenient). When outputting several pads at once, it is often
more efficient to call the pnoutrefresh() and doupdate() routines directly. A call to pnoutrefresh()
for each pad first, followed by only one call to
doupdate() to update the screen, results in one burst
of output, fewer characters sent, and less CPU time
used. Implementation Considerations | |
Identical to XPG/3 See Also | |
doupdate(), leaveok(), newpad(), Portability | |
HP-UX, UNIX System V, XPG/3 |
