CURS_BORDER(3CURSES) Curses Library Functions CURS_BORDER(3CURSES)


NAME


curs_border, border, wborder, box, whline, wvline - create curses
borders, horizontal and vertical lines

SYNOPSIS


cc [ flag ... ] file ... -lcurses [ library ... ]
#include <curses.h>

int border(chtype ls, chtype rs, chtype ts, chtype bs, chtype tl,
chtype tr, chtype bl,chtype br);


int wborder(WINDOW *win, chtype ls, chtype rs, chtype ts,
chtype bs, chtype tl, chtype tr, chtype bl, chtype br);


int box(WINDOW *win, chtype verch, chtype horch);


int hline(chtype ch, int n);


int whline(WINDOW *win, chtype ch, int n);


int vline(chtype ch, int n);


int wvline(WINDOW *win, chtype ch, int n);


DESCRIPTION


With the border(), wborder(), and box() routines, a border is drawn
around the edges of the window. The arguments and attributes are:


ls left side of the border
rs right side of the border
ts top side of the border
bs bottom side of the border
tl top left-hand corner
tr top right-hand corner
bl bottom left-hand corner
br bottom right-hand corner


If any of these arguments is zero, then the following default values
(defined in <curses.h>) are used respectively instead: ACS_VLINE,
ACS_VLINE, ACS_HLINE, ACS_HLINE, ACS_ULCORNER, ACS_URCORNER,
ACS_BLCORNER, ACS_BRCORNER.


box(win, verch, horch) is a shorthand for the following call:


wborder(win, verch, verch, horch, horch , 0, 0, 0, 0)


hline() and whline() draw a horizontal (left to right) line using ch
starting at the current cursor position in the window. The current cursor
position is not changed. The line is at most n characters long, or as
many as fit into the window.


vline() and wvline() draw a vertical (top to bottom) line using ch
starting at the current cursor position in the window. The current cursor
position is not changed. The line is at most n characters long, or as
many as fit into the window.

RETURN VALUES


All routines return the integer OK, or a non-negative integer if
immedok() is set. See curs_outopts(3CURSES).

ATTRIBUTES


See attributes(7) for descriptions of the following attributes:


+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+

SEE ALSO


curs_outopts(3CURSES), curses(3CURSES), attributes(7)

NOTES


The header <curses.h> automatically includes the headers <stdio.h> and
<unctrl.h>.


Note that border() and box() may be macros.


December 31, 1996 CURS_BORDER(3CURSES)