1curs_border(3CURSES)       Curses Library Functions       curs_border(3CURSES)
2
3
4

NAME

6       curs_border,  border, wborder, box, whline, wvline - create curses bor‐
7       ders, horizontal and vertical lines
8

SYNOPSIS

10       cc [ flag ... ] file ... -lcurses [ library ... ]
11       #include <curses.h>
12
13       int border(chtype ls, chtype rs, chtype ts, chtype bs, chtype tl,
14            chtype tr, chtype bl,chtype br);
15
16
17       int wborder(WINDOW *win, chtype ls, chtype rs, chtype ts,
18            chtype bs, chtype tl, chtype tr, chtype bl, chtype br);
19
20
21       int box(WINDOW *win, chtype verch, chtype horch);
22
23
24       int hline(chtype ch, int n);
25
26
27       int whline(WINDOW *win, chtype ch, int n);
28
29
30       int vline(chtype ch, int n);
31
32
33       int wvline(WINDOW *win, chtype ch, int n);
34
35

DESCRIPTION

37       With the border(), wborder(), and  box() routines, a  border  is  drawn
38       around the edges of the window. The arguments and attributes are:
39
40
41
42
43       ls                            left side of the border
44       rs                            right side of the border
45       ts                            top side of the border
46       bs                            bottom side of the border
47       tl                            top left-hand corner
48       tr                            top right-hand corner
49       bl                            bottom left-hand corner
50       br                            bottom right-hand corner
51
52
53
54       If  any  of  these arguments is zero, then the following default values
55       (defined in  <curses.h>)  are  used  respectively  instead:  ACS_VLINE,
56       ACS_VLINE,    ACS_HLINE,    ACS_HLINE,    ACS_ULCORNER,   ACS_URCORNER,
57       ACS_BLCORNER, ACS_BRCORNER.
58
59
60       box(win, verch, horch) is a shorthand for the following call:
61
62
63       wborder(win, verch, verch, horch, horch , 0, 0, 0, 0)
64
65
66       hline() and whline() draw a horizontal (left to right)  line  using  ch
67       starting at the current cursor position in the window. The current cur‐
68       sor position is not changed. The line is at most n characters long,  or
69       as many as fit into the window.
70
71
72       vline()  and  wvline()  draw  a  vertical (top to bottom) line using ch
73       starting at the current cursor position in the window. The current cur‐
74       sor  position is not changed. The line is at most n characters long, or
75       as many as fit into the window.
76

RETURN VALUES

78       All routines return the integer OK, or a non-negative integer if  imme‐
79       dok() is set. See curs_outopts(3CURSES).
80

ATTRIBUTES

82       See attributes(5) for descriptions of the following attributes:
83
84
85
86
87       ┌─────────────────────────────┬─────────────────────────────┐
88       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
89       ├─────────────────────────────┼─────────────────────────────┤
90       │MT-Level                     │Unsafe                       │
91       └─────────────────────────────┴─────────────────────────────┘
92

SEE ALSO

94       curs_outopts(3CURSES), curses(3CURSES), attributes(5)
95

NOTES

97       The header <curses.h> automatically includes the headers  <stdio.h> and
98       <unctrl.h>.
99
100
101       Note that border() and box() may be macros.
102
103
104
105SunOS 5.11                        31 Dec 1996             curs_border(3CURSES)
Impressum