Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

curses(3X)

curs_outopts(3X)



curs_border(3X)                                   curs_border(3X)



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

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);
     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 argument ls is a char-
     acter and attributes used for the left side of the border,
     rs - right side, ts - top side, bs - bottom side, tl - top
     left-hand corner, tr - top right-hand corner, bl - bottom
     left-hand corner, and br - bottom right-hand corner.  If any
     of these arguments is zero, then the following default
     values (defined in <curses.h>) are used 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 win-
     dow.  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 VALUE
     All routines return the integer OK, or a non-negative
     integer if immedok is set.

NOTES
     The header file <curses.h> automatically includes the header
     files <stdio.h> and <unctrl.h>.





Page 1                        CX/UX Programmer's Reference Manual





curs_border(3X)                                   curs_border(3X)



     Note that border and box may be macros.

SEE ALSO
     curses(3X), curs_outopts(3X).



















































Page 2                        CX/UX Programmer's Reference Manual



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026