derwin(3xcurses) 맨 페이지 - 윈디하나의 솔라나라

개요

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

derwin(3xcurses)

derwin(3XCURSES)        X/Open Curses Library Functions       derwin(3XCURSES)

NAME
       derwin, newwin, subwin - create a new window or subwindow

SYNOPSIS
       cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib \
       -R /usr/xpg4/lib -lcurses [ library... ]

       c89 [ flag... ] file... -lcurses [ library... ]

       #include <curses.h>

       WINDOW *derwin(WINDOW *orig, int nlines, int ncols,
            int begin_y, int begin_x);


       WINDOW *newwin(int nlines, int ncols, int begin_y, int begin_x);


       WINDOW *subwin(WINDOW *orig, int nlines, int ncols, int begin_y,
            int begin_x);

DESCRIPTION
       The  derwin() function creates a subwindow within window orig, with the
       specified number of lines and columns, and upper left corner positioned
       at begin_x, begin_y relative to window orig. A pointer to the new  win‐
       dow structure is returned.


       The newwin() function creates a new window with the specified number of
       lines and columns and upper left corner positioned at begin_x, begin_y.
       A pointer to the new window structure is returned. A full-screen window
       can be created by calling newwin(0,0,0,0).


       If the number of lines specified is zero, newwin() uses a default value
       of  LINES  minus  begin_y;  if the number of columns specified is zero,
       newwin() uses the default value of COLS minus begin_x.


       The subwin() function creates a subwindow within window orig, with  the
       specified number of lines and columns, and upper left corner positioned
       at  begin_x,  begin_y  (relative  to the physical screen, not to window
       orig). A pointer to the new window structure is returned.


       The original window and subwindow share character storage of the  over‐
       lapping  area (each window maintains its own pointers, cursor location,
       and other items). This means that characters and attributes are identi‐
       cal in overlapping areas regardless  of  which  window  characters  are
       written to.


       When using subwindows, it is often necessary to call touchwin(3XCURSES)
       before wrefresh(3XCURSES) to maintain proper screen contents.

PARAMETERS
       orig       Is a pointer to the parent window for the newly created sub‐
                  window.


       nlines     Is the number of lines in the subwindow.


       ncols      Is the number of columns in the subwindow.


       begin_y    Is  the  y  (row) coordinate of the upper left corner of the
                  subwindow, relative to the parent window.


       begin_x    Is the x (column) coordinate of the upper left corner of the
                  subwindow, relative to the parent window.


RETURN VALUES
       On success, these functions return a pointer to the newly-created  win‐
       dow. Otherwise, they return ERR.

ERRORS
       None.

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

       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ Interface StabilityCommitted _ MT-LevelUnsafe  _  Stan‐
       dardSee standards(7).


SEE ALSO
       doupdate(3XCURSES),  is_linetouched(3XCURSES), libcurses(3XCURSES), at‐
       tributes(7), standards(7)

Oracle Solaris 11.4               5 Jun 2002                  derwin(3XCURSES)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3