HPlogo HP-UX Reference Volume 4 of 5 > c

copywin(3X)

CURSES
» 

Technical documentation

Complete book in PDF

 » Table of Contents

 » Index

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 finer granularity of control over the overlay() and overwrite() functions. As in the prefresh() 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(). 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 defined.

SEE ALSO

newpad(3X), overlay(3X), <curses.h>.

CHANGE HISTORY

First released in X/Open Curses, Issue 4.

© Hewlett-Packard Development Company, L.P.