|
Curses Library Functions | curs_border(3CURSES) |
| 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); |
|
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.
|
|
All routines return the integer OK, or a non-negative integer if immedok() is set. See curs_outopts(3CURSES).
|
|
See attributes(5) for descriptions of the following
attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
MT-Level | Unsafe |
|
|
The header <curses.h> automatically includes the headers <stdio.h> and <unctrl.h>.
Note that border() and box() may be macros.
|
| |