newwin.3x (2010 09)

n
newwin(3X) newwin(3X)
(CURSES)
NAME
newwin, subwin — window creation functions
SYNOPSIS
#include <curses.h>
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 newwin() function creates a new window with nlines lines and ncols columns, positioned so that
the origin is (begin_y, begin_x). If nlines is zero, it defaults to
LINES − begin_y;ifncols is zero, it
defaults to
COLS − begin_x.
The
subwin() function creates a new window with nlines lines and ncols columns, positioned so that
the origin is at (begin_y, begin_x). (This position is an absolute screen position, not a position relative to
the window orig.) If any part of the new window is outside orig, the function fails and the window is not
created.
RETURN VALUE
Upon successful completion, these functions return a pointer to the new window. Otherwise, they return
a null pointer.
ERRORS
No errors are defined.
APPLICATION USAGE
Before performing the first refresh of a subwindow, portable applications should call
touchwin() or
touchline() on the parent window.
Each window maintains internal descriptions of the screen image and status. The screen image is shared
among all windows in the window hierarchy. Refresh operations rely on information on what has
changed within a window, which is private to each window. Refreshing a window, when updates were
made to a different window, may fail to perform needed updates because the windows do not share this
information.
A new full-screen window is created by calling:
newwin(0, 0, 0, 0);
SEE ALSO
delwin(3X), is_linetouched(3X), doupdate(3X), <curses.h>.
CHANGE HISTORY
First released in Issue 2
X/Open Curses, Issue 4
The entry is rewritten for clarity.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1