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 window
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
overlapping area (each window maintains its own pointers, cursor
location, and other items). This means that characters and attributes are
identical 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
subwindow.


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 window.
Otherwise, they return ERR.

ERRORS


None.

ATTRIBUTES


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


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+

SEE ALSO


doupdate(3XCURSES), is_linetouched(3XCURSES), libcurses(3XCURSES),
attributes(7), standards(7)

illumos June 5, 2002 DERWIN(3XCURSES)