copywin

The copywin routine is used to overlay or overwrite any portion of window.

Syntax

   #include <curses.h>



   int copywin(WINDOW *srcwin, WINDOW *dstwin, int sminrow, int smincol,

   int dminrow, int dmincol, int dmaxrow, int dmaxcol, int overlay);

Parameters

srcwin: A pointer to the source window to be copied.
dstwin: A pointer to the destination window to be overlayed or overwritten.
smincol: The column coordinate of the upper-left corner of the rectangular area on the source window to be copied.
sminrow: The row coordinate of the upper-left corner of the rectangular area on the source window to be copied.
dmincol: The column coordinate of the upper-left corner of the rectangular area on destination window to be overlayed or overwritten.
dminrow: The row coordinate of the upper-left corner of the rectangular area on the destination window to be overlayed or overwritten.
dmaxcol: The column coordinate of the lower-right corner of the rectangular area on the destination window to be overlayed or overwritten.
dmaxrow: The row coordinate of the lower-right corner of the rectangular area on the destination window to be overlayed or overwritten.
overlay: A true or false value that determines whether the destination window is overlayed or overwritten.

Return Values

OK: Successful completion.
ERR: An error occurred.

Description

The copywin() routine overlays or overwrites windows similiar to the overlay() and overwrite() functions; however, copywin() allows a finer degree of control on what portion of the window to overlay or overwrite.

The parameters smincol and sminrow specify the upper-left corner of the rectangular area of the source window to be copied. The dminrow and dmincol parameters specify the upper-left corner of the rectangular area of the destination window to which the specified portion of the source is to be copied. The dmaxrow and dmaxcol parameters specify the bottom-right corner of the rectangular area of the destination window to which the specified portion of the source is to be copied.

If overlay is TRUE, only nonblank characters are copied to the destination window; if FALSE, all characters are copied.

Implementation Considerations

UNIX System V implementation

Portability

UNIX System V

copywin

Technical documentation

» Table of Contents

» Index