Content-type: text/html
curs_overlay, copywin, overlay, overwrite - Overlap and manipulate overlapped Curses windows
#include <curses.h>
int overlay(
const WINDOW *srcwin,
WINDOW *dstwin
);
int overwrite(
const WINDOW *srcwin,
WINDOW *dstwin
);
int copywin(
const WINDOW *srcwin,
WINDOW *dstwin,
int sminrow,
int smincol,
int dminrow,
int dmincol,
int dmaxrow,
int dmaxcol,
int overlay
);
Interfaces documented on this reference page conform to industry standards as follows:
overlay, overwrite: XPG4, XPG4-UNIX
copywin: XPG4-UNIX
Refer to the
standards(5)
reference page for more information
about industry standards and associated tags.
The overlay and overwrite routines overlay srcwin on top of dstwin. The scrwin and dstwin parameters do not have to be the same size; Curses copies only the text in the region where the two windows overlap. The difference between the routines is that overlay is nondestructive (blanks are not copied), whereas overwrite is destructive.
The
copywin
routine provides a finer granularity
of control over the same operation performed by
overlay
and
overwrite. Like the
prefresh
routine,
copywin
specifies a rectangle in the destination window, (dminrow,
dmincol) and (dmaxrow,
dmaxcol), and the upper-left-corner
coordinates of the source window, (sminrow,
smincol). If the argument
overlay
is
true, then copying is nondestructive, as is the case
for the
overlay
function.
The header file
<curses.h>
automatically
includes the header file
<stdio.h>.
These routines return
ERR
upon failure and
OK
upon successful completion.
Functions: curses(3), curs_pad(3), curs_refresh(3)
Others: standards(5)