| |
| X/Open Curses Library Functions | border(3XCURSES) |
| | border, box, wborder - add a single-byte border to a window |
SYNOPSIS
| |
#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); |
| |
The border() and wborder() functions draw a border around the specified window. All parameters must be single-byte characters whose rendition can be expressed
using only constants beginning with ACS_. A parameter with the value of 0 is replaced by the default value.
| Constant Values for Borders |
| Parameter | Default Constant | Default Character |
| verch | ACS_VLINE | | |
| horch | ACS_HLINE | - |
| ls | ACS_VLINE | | |
| rs | ACS_VLINE | | |
| ts | ACS_HLINE | - |
| bs | ACS_HLINE | - |
| bl | ACS_BLCORNER | + |
| br | ACS_BRCORNER | + |
| tl | ACS_ULCORNER | + |
| tr | ACS_URCORNER | + |
The call is a short form for
| |
wborder(win,
verch, verch,
horch, horch, 0, 0, 0,
0)
|
When the window is boxed, the bottom and top rows and right and left columns overwrite existing text.
|
| |
-
ls
- Is the character and rendition used for the left side of the border.
-
rs
- Is the character and rendition used for the right side of the border.
-
ts
- Is the character and rendition used for the top of the border.
-
bs
- Is the character and rendition used for the bottom of the border.
-
tl
- Is the character and rendition used for the top-left corner of the border.
-
tr
- Is the character and rendition used for the top-right corner of the border.
-
bl
- Is the character and rendition used for the bottom-left corner of the border.
-
br
- Is the character and rendition used for the bottom-right corner of the border.
-
win
- Is the pointer to the window in which the border or box is to be drawn.
-
verch
- Is the character and rendition used for the left and right columns of the box.
-
horch
- Is the character and rendition used for the top and bottom rows of the box.
|
| |
On success, these functions return OK. Otherwise, they return ERR.
|
| |
