Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

touchwin(3)

wrefresh(3)

subwin(3)  —  Subroutines

Digital

NAME

subwin − create subwindow

SYNOPSIS

#include <curses.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 nlines lines and ncols columns. The sub-window is at position (begin_y, begin_x) on the screen.  This position is relative to the screen and not to the window orig. 

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

RETURN VALUES

On success, the subwin function returns a pointer to the new WINDOW structure created. On failure, the function returns a null pointer. 

RELATED INFORMATION

touchwin(3), wrefresh(3)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026