Curses Library Functions                     cursborder(3CURSES)



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

SYNOPSIS
     cc [ flag ... ] file ... -lcurses [ library ... ]
     #include 

     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 arguments and
     attributes are:



     ls                            left side of the border
     rs                            right side of the border
     ts                            top side of the border
     bs                            bottom side of the border
     tl                            top left-hand corner
     tr                            top right-hand corner
     bl                            bottom left-hand corner
     br                            bottom right-hand corner



     If any of  these  arguments  is  zero,  then  the  following
     default values (defined in ) are used respectively
     instead:   ACSVLINE,   ACSVLINE,   ACSHLINE,   ACSHLINE,



SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions                     cursborder(3CURSES)



     ACSULCORNER, ACSURCORNER, ACSBLCORNER, ACSBRCORNER.


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


     vline() and wvline() draw a vertical (top  to  bottom)  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 win-
     dow.

RETURN VALUES
     All routines  return  the  integer  OK,  or  a  non-negative
     integer if immedok() is set. See cursoutopts(3CURSES).

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     cursoutopts(3CURSES), curses(3CURSES), attributes(5)

NOTES
     The header   automatically  includes  the  headers
      and .


     Note that border() and box() may be macros.






SunOS 5.11          Last change: 31 Dec 1996                    2