Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

curses(3curses)

curs_outopts(3curses)






       curs_border(3curses)                            curs_border(3curses)


       NAME
             curs_border: border, wborder, box, hline, whline, vline,
             wvline - create curses borders, 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 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_LLCORNER, ACS_LRCORNER.

             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 Values
             All routines return the integer OK, or a non-negative integer
             if immedok is set.



                           Copyright 1994 Novell, Inc.               Page 1













      curs_border(3curses)                            curs_border(3curses)


      REFERENCES
            curses(3curses), curs_outopts(3curses)

      NOTICES
            The header file curses.h automatically includes the header
            files stdio.h and unctrl.h.

            Note that border and box may be macros.








































                          Copyright 1994 Novell, Inc.               Page 2








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