|
|
curs_border(3CURSES) Curses Library Functions curs_border(3CURSES)
NAME
curs_border, border, wborder, box, whline, wvline - create curses bor‐
ders, 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 cur‐
sor 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 cur‐
sor 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 imme‐
dok() is set. See curs_outopts(3CURSES).
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │Unsafe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSO
curs_outopts(3CURSES), curses(3CURSES), attributes(5)
NOTES
The header <curses.h> automatically includes the headers <stdio.h> and
<unctrl.h>.
Note that border() and box() may be macros.
SunOS 5.10 31 Dec 1996 curs_border(3CURSES)
[top]
|
Vote for polarhome |
