HP 3000 Manuals HP 3000 Manuals
prefresh, pnoutrefresh
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