subwin

The subwin routine is used to create a subwindow relative to the physical screen.

Syntax

   #include <curses.h>



   WINDOW *subwin(WINDOW *orig, int nlines, int ncols, int begin_y,

   int begin_x);

Parameters

orig: The parent window of the subwindow.
nlines: The number of lines in the subwindow.
ncols: The number of columns in the subwindow
begin_y: The y (row) coordinate of the upper-left corner of the window.
begin_x: The x (column) coordinate of the upper-left corner of the window.

Return Values

On success, a pointer to the new window structure is returned; otherwise, a null pointer is returned.

Description

The subwin() routine 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() before wrefresh() to maintain proper screen contents.




	NOTE: The `derwin()` routine creates a subwindow in exactly the same way, but allows you to specify coordinates relative to window `orig`.

Implementation Considerations

Identical to XPG/3

Portability

HP-UX, UNIX System V, XPG/3

subwin

Technical documentation

» Table of Contents

» Index