HP 3000 Manuals

MPE/iX Developer's Kit Reference Manual Volume II

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

See Also 

overlay(), overwrite()

Portability 

UNIX System V

MPE/iX 5.0 Documentation