Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

subwin(3cur) [ultrix man page]

subwin(3cur)															      subwin(3cur)

Name
       subwin - create subwindow

Syntax
       #include <cursesX.h>

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

Description
       This routine creates a new sub-window within a window.  The dimensions of the sub-window are lines and columns.	The sub-window is at posi-
       tion (on the screen.  This position is relative to the screen, and not to the window

       The sub-window is made in the middle of the window so that changes made to either window will affect both.  When  using	this  routine,	it
       will often be necessary to call before calling

Return Values
       On success the function returns a pointer to the new WINDOW structure created.  On failure the function returns a null pointer.

See Also
       touchwin(3cur), wrefresh(3cur)

																      subwin(3cur)

Check Out this Related Man Page

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 posi- tioned 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 posi- tioned 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(5) 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(5), standards(5) SunOS 5.11 5 Jun 2002 derwin(3XCURSES)
Man Page