Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
Curses Library Functionscurs_overlay(3CURSES)


NAME

 curs_overlay, overlay, overwrite, copywin - overlap and manipulate overlapped curses windows

SYNOPSIS

 
cc [ flag ... ] file ... -lcurses [ library ... ]
#include <curses.h>
int overlay(WINDOW *srcwin, WINDOW *dstwin);
 int overwrite(WINDOW *srcwin, WINDOW *dstwin);
 int copywin(WINDOW *srcwin, WINDOW *dstwin, int sminrow, int smincol, int dminrow, int dmincol, int dmaxrow, int dmaxcol, int overlay);

DESCRIPTION

 

The overlay() and overwrite() routines overlay srcwin on top of dstwin. scrwin and dstwin are not required to be the same size; only text where the two windows overlap is copied. The difference is that overlay() is non-destructive (blanks are not copied) whereas overwrite() is destructive.

The copywin() routine provides a finer granularity of control over the overlay() and overwrite() routines. Like in the prefresh() routine, 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 the argument overlay is true, then copying is non-destructive, as in overlay().


RETURN VALUES

 

Routines that return an integer return ERR upon failure and an integer value other than ERR upon successful completion.


ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelUnsafe

SEE ALSO

 

curs_pad(3CURSES), curs_refresh(3CURSES), curses(3CURSES), attributes(5)


NOTES

 

The header <curses.h> automatically includes the headers <stdio.h> and <unctrl.h>.

Note that overlay() and overwrite may be macros.



SunOS 5.9Go To TopLast Changed 31 Dec 1996