CURSES

NAME

copywin — copy a region of a window

SYNOPSIS

#include <curses.h>

int copywin(WINDOW * const 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(), overlay(), <curses.h>. 

CHANGE HISTORY

First released in X/Open Curses, Issue 4. 

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