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 character 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 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.

   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>.





   8/91                                                                 Page 1









   curs_border(3X)                                             curs_border(3X)


         Note that border and box may be macros.

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

















































   Page 2                                                                 8/91





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