curs_overlay(3x) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

curs_overlay(3x)

curs_overlay(3x)                 Library calls                curs_overlay(3x)

NAME
       overlay,  overwrite,  copywin  -  overlay curses windows and manipulate
       them

SYNOPSIS
       #include <ncursesw/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);

DESCRIPTION
   overlay, overwrite
       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  destruc‐
       tive.

   copywin
       The  copywin  routine  provides a finer granularity of control over the
       overlay and overwrite routines.  As in the prefresh routine, a  rectan‐
       gle  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 VALUE
       These functions return OK on success and ERR on failure.

       In ncurses, they return ERR if

       •   either of the window pointers are null, or

       •   any part of the window would be placed off-screen.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       box; cbp-1 | cbp-1 l | l .  ATTRIBUTE TYPE ATTRIBUTE VALUE = Availabil‐
       ity   library/ncurses = Stability Uncommitted

NOTES
       overlay and overwrite may be implemented as macros.

       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at:
       https://github.com/oracle/solaris-userland

       The original community source was downloaded from:
       https://invisible-mirror.net/archives/ncurses/cur‐
       rent/ncurses-6.5-20250614.tgz

       Further information about this software can be found on the open source
       community website at https://invisible-island.net/ncurses/.

PORTABILITY
       X/Open Curses Issue 4 describes these functions.  It specifies no error
       conditions for them.  It adds const qualifiers to  the  arguments.   It
       further  specifies  their  behavior  in the presence of characters with
       multibyte renditions (not yet supported in this implementation).

       SVr4 describes a successful return value  only  as  “an  integer  value
       other than ERR”.

SEE ALSO
       curses(3X), curs_pad(3X), curs_refresh(3X)


ncurses 6.5                       2025-01-18                  curs_overlay(3x)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3