Creates a new subwindow with numlines lines and
numcols columns starting at the coordinates (begin_
y,begin_x) on the terminal screen.
Format
#include <curses.h>
WINDOW *subwin (WINDOW *win, int numlines,
int numcols, int begin_y, int
begin_x);
Arguments
- win
- A pointer to the parent window.
- numlines
- The number of lines in the subwindow. If numlines is 0,
then the function sets that dimension to LINES - begin_y.
To get a subwindow of dimensions LINES by COLS, use the following
format:
subwin (win, 0, 0, 0, 0)
- numcols
- The number of columns in the subwindow. If numcols is
0, then the function sets that dimension to COLS - begin_x.
To get a subwindow of dimensions LINES by COLS, use the following
format:
subwin (win, 0, 0, 0, 0)
- begin_y
- A window coordinate at which the subwindow is to be created.
- begin_x
- A window coordinate at which the subwindow is to be created.
Description
When creating the subwindow, begin_y and begin_
x are relative to the entire terminal screen. If either
numlines or numcols is 0, then the subwin function
sets that dimension to (LINES - begin_y) or (COLS -
begin_x), respectively.
The window pointed to by win must be large enough to
contain the entire area of the subwindow. Any changes made to
either window within the coordinates of the subwindow appear on
both windows.
Return Values
| window pointer | A pointer to an
instance of the structure window corresponding to the newly created
subwindow. |
| ERR | Indicates an
error. |
Previous Page | Next Page | Table of Contents | Index