HP-UX Reference (11i v2 03/08) - 3 Library Functions A-M (vol 6)
c
copywin(3X) copywin(3X)
(CURSES)
NAME
copywin — copy a region of a window
SYNOPSIS
#include <curses.h>
int copywin(const WINDOW *srcwin, WINDOW *dstwin, int sminrow,
int smincol, int dminrow, int dmincol, int dmaxrow,
int dmaxcol, int overlay);
DESCRIPTION
The copywin() function provides a finer granularity of control over the
overlay() and
overwrite() functions. As in the prefresh() function, a rectangle is specified in the destination
window, (dminrow, dmincol) and (dmaxrow, dmaxcol), and the upper-left-corner coordinates of the source
window, (sminrow, smincol). If overlay is TRUE, then copying is non-destructive, as in
overlay().If
overlay is FALSE, then copying is destructive, as in
overwrite().
RETURN VALUE
Upon successful completion,
copywin() returns OK. Otherwise, it returns ERR.
ERRORS
No errors are defined.
SEE ALSO
newpad(3X), overlay(3X), <curses.h>.
CHANGE HISTORY
First released in X/Open Curses, Issue 4.
Section 3−−116 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: August 2003