copywin.3x (2010 09)

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 ﬁner granularity of control over the

overlay() and

overwrite() functions. As in the prefresh() function, a rectangle is speciﬁed 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 deﬁned.