copywin(3curses)

copywin -- copy a region of a window

Synopsis

cc [options] file -lcurses

#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(3curses) function provides a finer granularity of control over the overlay(3curses) and overwrite(3curses) functions. As in the prefresh(3curses) 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(3curses). If overlay is FALSE, then copying is destructive, as in overwrite(3curses).

Return value

Upon successful completion, copywin(3curses) returns OK. Otherwise, it returns ERR.

Errors

No errors are defined.

Standards Conformance

The Single UNIX Specification, Version 2; The Open Group.

References

newpad(3curses), overlay(3curses), curses(4)